Skip to main content
Users
CloudPortalLogin
  • Powered byPowered by
Developing with Sitecore CDP
Data privacy
Before you start sending data
Integrating with Sitecore CDP
Stream API
Batch API
REST APIs
Data lake export service
  • Sitecore CDP for developers
  • REST APIs
  • Legacy REST APIs
  • Order REST API v2 (legacy)
  • Retrieve orders (legacy)

Retrieve orders (legacy)

Important

A newer version of this REST API (v2.1) is available. If you're new to this REST API, use the new version. Alternatively, if you're already using the old version, read about the differences between v2 and v2.1 so you can upgrade.

Make one of the following requests:

  • GET /v2/orders?referenceId=<referenceId>

  • GET /v2/orders?guestRef=<guestRef>

Retrieves a list of orders. You must include either the referenceId of the order or the guestRef as a query string parameter in the URI of the request.

Parameter name

Type

Description

Example

referenceId

string

A unique ID generated by your organization to reference the order. For flight orders, this is often the PNR.

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

guestRef

string

The reference of the guest record.

If you do not know the guest reference, first retrieve guests.

f7aabbca-1c1b-4fc2-be72-3e16294a4f03

In the response, in items.href, the order reference is the string that follows the final slash:

"href": "<baseURL>/v2/orders/<orderRef>"

You use the order reference to interact with a specific order, for example, to retrieve or update it.

Retrieving orders using referenceId:

RequestResponse
curl -X GET '<baseURL>/v2/orders?referenceId=2d7de9df-45a2-45ea-872c-30e45139007d' \
-u '<username>:<password>' \
-H 'Accept: application/json'

Retrieving orders using guestRef:

RequestResponse
curl -X GET '<baseURL>/v2/orders?guestRef=f7aabbca-1c1b-4fc2-be72-3e16294a4f03' \
-u '<username>:<password>' \
-H 'Accept: application/json'
RequestResponse
{
    "href": "<baseURL>/v2/orders?offset=0&limit=10&guestRef=f7aabbca-1c1b-4fc2-be72-3e16294a4f03",
    "offset": 0,
    "limit": 10,
    "first": {
        "href": "<baseURL>/v2/orders?offset=0&limit=10&guestRef=f7aabbca-1c1b-4fc2-be72-3e16294a4f03"
    },
    "last": {
        "href": "<baseURL>/v2/orders?offset=0&limit=10&guestRef=f7aabbca-1c1b-4fc2-be72-3e16294a4f03"
    },
    "items": [
        {
            "href": "<baseURL>/v2/orders/d680c9be-4c07-4731-857e-9602034b15f2"
        },
        {
            "href": "<baseURL>/v2/orders/9932bee2-25c2-4653-9ad3-8865865036d9"
        },­­­
        {
            "href": "<baseURL>/v2/orders/4b8eeee6-37f1-41ad-92fb-79e802db29a7"
        }
    ]
}

Do you have some feedback for us?

If you have suggestions for improving this article,

Privacy policySitecore Trust CenterCopyright © 1999-2025 Sitecore