v1

latestOpenAPI 3.0.12026-07-242871595.3 MB
ORDERS

Get orders

Retrieves a list of the merchant's orders. Newest order displays first in the list.

get/v1/orders

Query parameters

gtstring date-time

Displays results when the created field is greater than the current value.

gtestring date-time

Displays results when the created field is greater than or equal to the current value.

ltstring date-time

Displays results when the created field is less than the current value.

ltestring date-time

Displays results when the created field is less than or equal to the current value.

Filters orders by their creation time. Accepts either a Unix timestamp (in milliseconds) to match a specific creation time, or an object to specify a time range.

Examples:

  • created=1633046400000 (orders created at this exact time)
  • created[gt]=1633046400000 (orders created after this time)
  • created[gte]=1633046400000 (orders created at or after this time)
  • created[lt]=1633132800000 (orders created before this time)
  • created[lte]=1633132800000 (orders created at or before this time)

You can combine these for a range, e.g. created[gte]=1633046400000&created[lte]=1633132800000 to get orders created between two timestamps.

Timestamps must be in milliseconds since Unix epoch.

customerstring

Returns orders for a specific customer.

ending_beforestring

Cursor used in pagination. The ending_before object ID sets your place in the list. For example, if you receive 100 objects in a list starting with obj_bar, add ending_before=obj_bar in your subsequent request to retrieve the previous page of the list.

expandstring[]

Additional information provided as an expanded response, for example, related object nested within the parent. See Use expandable fields.

idsstring[]

Universally unique identifier (UUID) of the order.

limitinteger

Number of objects returned by the request, ranging between 1 and 100. Default value: 10

starting_afterstring

Cursor used in pagination. The starting_after object ID sets your place in the list. For example, if you receive 100 objects in a list starting with obj_foo, add starting_after=obj_foo in your subsequent request to retrieve the next page of the list.

statusstring

Displays orders based on status—created, paid, fulfilled, or refunded.

Displays orders based on the time of a status change—paid, fulfilled, canceled, or returned.

Headers

User-Agentstring required

Identifies the application, operating system, vendor, and/or version of the requesting user agent. Format: <AppName>/<Version> <Comment>

Response

Successful response. A list of orders displayed.

has_moreboolean required

Set to true if there is another page of list items after the current page

object'list' required

Object type, set to list. Objects with the same type have the same value.

urlstring required

URL of the list