# List order contacts for an order

Retrieves a list of order contacts for an order.

 In the response, items.ref contains the order contact reference. Use the order contact reference to interact with a specific order contact, for example, to retrieve or update it.

Endpoint: GET /v2.1/orders/{orderRef}/contacts
Version: v2.1
Security: BasicAuth

## Path parameters:

  - `orderRef` (string, required)
    The order reference. This is a unique identifier of the order record. Automatically generated when you created the order. If you don't know the order reference, first list orders.
    Example: "2d7de9df-45a2-45ea-872c-30e45139007d"

## Query parameters:

  - `expand` (object)
    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: true

## Response 200 fields (application/json):

  - `offset` (integer)
    The request's offset.

  - `limit` (integer)
    The request's limit.
    Example: 10

  - `first` (object)
    The request's first list of order contacts URL.

  - `first.href` (string)
    Example: "https://api-engage-eu.sitecorecloud.io/v2.1/orders/2d7de9df-45a2-45ea-872c-30e45139007d/contacts?offset=1&limit=10"

  - `last` (object)
    The request's last list of order contacts URL.

  - `last.href` (string)
    Example: "https://api-engage-eu.sitecorecloud.io/v2.1/orders/2d7de9df-45a2-45ea-872c-30e45139007d/contacts?offset=1&limit=10"

  - `next` (object)
    The request's next list of order contacts URL.

  - `next.href` (string)
    Example: "https://api-engage-eu.sitecorecloud.io/v2.1/orders/2d7de9df-45a2-45ea-872c-30e45139007d/contacts?offset=1&limit=10"

  - `href` (string)
    The request's URL.
    Example: "https://api-engage-eu.sitecorecloud.io/v2.1/orders/cadd106a-feff-42b2-90fb-a6ed136ece51/contacts?offset=0&limit=10"

  - `items` (array)
    The order contacts's items.

  - `items.href` (string)
    Example: "https://api-engage-eu.sitecorecloud.io/v2.1/orders/cadd106a-feff-42b2-90fb-a6ed136ece51/contacts/111d106a-feff-42b2-90fb-a6ed136ec333"

## Response 401 fields (application/json):

  - `status` (string)
    The HTTP request status.
    Example: "UNAUTHORIZED"

  - `code` (integer)
    The HTTP response status code.
    Example: 401

  - `message` (string)
    Error description.
    Example: "Authentication credentials are required to access the resource. All requests must be authenticated."

  - `moreInfoUrl` (string)
    URL to get more information about the error.
    Example: "https://support.sitecore.com"