Retrieve the URL for an order item's data extension

Request

Retrieves the URL for the order item's data extension. This lets you check if the data extension exists.

Security

BasicAuth

Path

orderItemRefstring, (UUID)required

The order item reference. This is a unique identifier of the order item. Automatically generated when you created the order item. If you don't know the order item reference, first list order items.

Example:2d7de9df-45a2-45ea-872c-30e45139007d

Query

expandArray of strings

You can expand items in a collection by setting expand=true. This eliminates the need to send multiple follow-up requests (one for the collection and another for each of its items). This also helps you check if the data you intend to create already exists.

Example:expand=true

offsetobject(Offset)

Collection responses use offset pagination. The offset query parameter is used to exclude from a response the first N items of the entire resource collection.

Default:"0"

Example:offset=0

limitobject, [ 10 .. 100 ](Limit)

Collection responses use offset pagination. This query parameter lets you adjust the maximum number of collection items to return for a single request.

Default:"10"

Example:limit=40

curl -i -X GET \
  -u '<username>:<password>' \
  'https://api-engage-ap.sitecorecloud.io/v2.1/orderItems/2d7de9df-45a2-45ea-872c-30e45139007d/extensions?expand=true&offset=0&limit=40'

Responses

Successful operation

Bodyapplication/json

namestring

The name of the data extension.

Example:"ext"

offsetinteger, (int32)

The request's offset.

Example:0

limitinteger, (int32)

The request's limit.

Example:10

firstobject(OrderItemDataExtensionFirstLink)

The request's first list of order item data extensions URL.

lastobject(OrderItemDataExtensionLastLink)

The request's last list of order item data extensions URL.

nextobject(OrderItemDataExtensionNextLink)

The request's next list of order item data extensions URL.

hrefstring

The request's URL.

Example:"https://api-engage-eu.sitecorecloud.io/v2.1/orderItems/cadd106a-feff-42b2-90fb-a6ed136ece51/extensions"

itemsArray of objects(OrderItemDataExtensionLink)

The request's data extension items.

orderobject(OrderHref)

Response

{
  "name": "ext",
  "offset": 0,
  "limit": 10,
  "first": {
    "href": "https://api-engage-eu.sitecorecloud.io/v2.1/orderItems/cadd106a-feff-42b2-90fb-a6ed136ece51/extensions"
  },
  "last": {
    "href": "https://api-engage-eu.sitecorecloud.io/v2.1/orderItems/cadd106a-feff-42b2-90fb-a6ed136ece51/extensions"
  },
  "next": {
    "href": "https://api-engage-eu.sitecorecloud.io/v2.1/orderItems/cadd106a-feff-42b2-90fb-a6ed136ece51/extensions"
  },
  "href": "https://api-engage-eu.sitecorecloud.io/v2.1/orderItems/cadd106a-feff-42b2-90fb-a6ed136ece51/extensions",
  "items": [
    { … }
  ],
  "order": {
    "href": "https://api-engage-eu.sitecorecloud.io/v2.1/orders/cadd106a-feff-42b2-90fb-a6ed136ece51"
  }
}