List Orders
GET/commerce/orders
List orders for a specified connection
Request
Query Parameters
The ID of the credential.
The page number of the results. Default is 1.
The maximum number of results to show on a page. Default is 50. Maximum is 100.
A string used to retrieve orders with a specific order number.
A string used to retrieve orders with an order number containing a specific value.
A string that should not match the order number of orders to be retrieved.
A string used to retrieve orders with a specific order status.
A string used to retrieve orders with an order status containing a specific value.
A string that should not match the order status of orders to be retrieved.
A string used to retrieve orders with a specific fulfillment status.
A string used to retrieve orders with a fulfillment status containing a specific value.
A string that should not match the fulfillment status of orders to be retrieved.
A specific value used to retrieve orders with a matching shipping total.
The minimum allowed value for filtering orders based on their shipping total.
The maximum allowed value for filtering orders based on their shipping total.
A value that should not match the shipping total of orders to be retrieved.
A specific value used to retrieve orders with a matching discount total.
The minimum allowed value for filtering orders based on their discount total.
The maximum allowed value for filtering orders based on their discount total.
A value that should not match the discount total of orders to be retrieved.
A specific value used to retrieve orders with a matching tax total.
The minimum allowed value for filtering orders based on their tax total.
The maximum allowed value for filtering orders based on their tax total.
A value that should not match the tax total of orders to be retrieved.
A specific value used to retrieve orders with a matching total price.
The minimum allowed value for filtering orders based on their total price.
The maximum allowed value for filtering orders based on their total price.
A value that should not match the total price of orders to be retrieved.
A string used to retrieve orders with a specific currency.
A string used to retrieve orders with a currency containing a specific value.
A string that should not match the currency of orders to be retrieved.
A string used to retrieve orders with a specific payment status.
A string used to retrieve orders with a payment status containing a specific value.
A string that should not match the payment status of orders to be retrieved.
Filter objects created in the third-party application after a specified date.
Filter objects created in the third-party application before a specified date.
Filter objects last updated in the third-party application after a specified date.
Filter objects last updated in the third-party application before a specified date.
Filter objects created after a specified date.
Filter objects created before a specified date.
Filter objects last updated after a specified date.
Filter objects last updated before a specified date.
Header Parameters
Default value: bearer YOUR_API_KEY
Responses
- 200
- 400
200
- application/json
- Schema
- Example (from schema)
- Result
Schema
Array [
Array [
]
]
orders
object[]
lineItems
object[]
Default value: 0
customer
object
Default value: true
{
"orders": [
{
"id": "00000000-0000-0000-0000-000000000000",
"remoteId": "2191357149242",
"orderStatus": "Active",
"lineItems": [
{
"quantity": 1,
"productId": "4463254208570",
"price": "1000.00",
"unitCost": "",
"currency": "USD",
"variantId": "31586061353018",
"title": "T-Shirt",
"sku": "shirt-01"
}
],
"orderNumber": "1001",
"paymentStatus": "Paid",
"customer": {
"customerId": "3046096732218",
"firstName": "Chase",
"lastName": "Red",
"phone": "",
"email": "chasered@runalloy.com"
},
"currency": "USD",
"totalPrice": "1000.00",
"totalDiscount": "0.00",
"totalShipping": "0.00",
"totalTax": "0.00",
"fulfillmentStatus": "unfulfilled",
"remoteCreatedAt": "2023-11-19T17:00:17.000Z",
"remoteUpdatedAt": "2023-11-19T17:00:17.000Z",
"remoteDeleted": false,
"createdAt": "2024-02-22T11:17:53.264Z",
"updatedAt": "2024-02-22T13:54:03.445Z"
}
]
}
{
"orders": [
{
"id": "00000000-0000-0000-0000-000000000000",
"remoteId": "2191357149242",
"orderStatus": "Active",
"lineItems": [
{
"quantity": 1,
"productId": "4463254208570",
"price": "1000.00",
"unitCost": "",
"currency": "USD",
"variantId": "31586061353018",
"title": "T-Shirt",
"sku": "shirt-01"
}
],
"orderNumber": "1001",
"paymentStatus": "Paid",
"customer": {
"customerId": "3046096732218",
"firstName": "Chase",
"lastName": "Red",
"phone": "",
"email": "chasered@runalloy.com"
},
"currency": "USD",
"totalPrice": "1000.00",
"totalDiscount": "0.00",
"totalShipping": "0.00",
"totalTax": "0.00",
"fulfillmentStatus": "unfulfilled",
"remoteCreatedAt": "2023-11-19T17:00:17.000Z",
"remoteUpdatedAt": "2023-11-19T17:00:17.000Z",
"remoteDeleted": false,
"createdAt": "2024-02-22T11:17:53.264Z",
"updatedAt": "2024-02-22T13:54:03.445Z"
}
]
}
400
- application/json
- Schema
- Example (from schema)
- Result
Schema
{}
{}