v1
latestOpenAPI 3.0.12026-07-242871595.3 MBGet orders
Retrieves a list of the merchant's orders. Newest order displays first in the list.
Query parameters
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.
Returns orders for a specific customer.
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.
Additional information provided as an expanded response, for example, related object nested within the parent. See Use expandable fields.
Universally unique identifier (UUID) of the order.
Number of objects returned by the request, ranging between 1 and 100. Default value: 10
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.
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
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.