updatedOrders

The updatedOrders query allows you to filter orders by their updated date.

2 minute read

Key Information

Use-Case

The updatedOrders query allows operators to return orders updated since the provided timestamp. This can be useful when you want to sync order updates from Marketplacer to your connected integration.

Further Points of Note

N/a

Availability

Operator API: Yes
Seller API: No

Example

query getOrderUpdatedSince{
  updatedOrders(
    first: 10,
    after: null, 
    updatedSince: "2021-06-23") {
    totalCount
    pageInfo{
      hasNextPage
      endCursor
    }
    nodes {
      id
      legacyId
      createdAt
      updatedAt
      status
      externalIds {
        id
        key
        value
      }
      messageToSeller
      invoices {
        edges {
          node {
            id
            legacyId
            statusFlags
            updatedAt
          }
        }
      }
      externalIds {
        id
        key
        value
      }
      metadata {
        key
        value
      }
    }
  }
}

Arguments

Name	Type	Description
updatedSince	ISO8601DateTime	Return orders updated since the provided time stamp
after	String	Pagination cursor for moving through result set - more on pagination here
before	String	Not in use - backwards pagination not supported
first	Int	Pagination page size - more on pagination here
last	Int	Not in use - backwards pagination not supported

Response

Returns UpdatedOrdersConnection

Error Responses

HTTP Error	Error Message	Meaning
401	Unauthorized	You don’t have access to the endpoint, likely Basic Authentication credentials are missing
401	API Token has expired	You don’t have access to the endpoint, likely that you are either not supplying an API Key, or the key you are supplying is invalid