List Orders
List Orders
Query parameters
Include raw response. Mostly used for debugging purposes
Cursor to start from. You can find cursors for next/previous pages in the meta.cursors property of the response.
Number of results to return. Minimum 1, Maximum 200, Default 20
ID of the location.
The 'fields' parameter allows API users to specify the fields they want to include in the API response. If this parameter is not present, the API will return all available fields. If this parameter is present, only the fields specified in the comma-separated string will be included in the response. Nested properties can also be requested by using a dot notation. <br /><br />Example: fields=name,email,addresses.city<br /><br />In the example above, the response will only include the fields "name", "email" and "addresses.city". If any other fields are available, they will be excluded.
Headers
ID of the consumer which you want to get or push data from
The ID of your Unify application
Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API.
Response
Orders
Example response
{
"status_code": 200,
"status": "OK",
"service": "clover",
"resource": "orders",
"operation": "all",
"data": [
{
"id": "12345",
"idempotency_key": "random_string",
"order_number": "1F",
"order_date": "2022-08-12",
"closed_date": "2022-08-13",
"reference_id": "my-order-001",
"status": "open",
"payment_status": "open",
"currency": "USD",
"merchant_id": "12345",
"customer_id": "12345",
"employee_id": "12345",
"location_id": "12345",
"order_type_id": "12345",
"table": "1F",
"seat": "23F",
"total_amount": 275,
"total_tip": 700,
"total_tax": 275,
"total_discount": 300,
"customers": [
{
"id": "12345",
"first_name": "Elon",
"middle_name": "D.",
"last_name": "Musk",
"phone_numbers": [
{
"id": "12345",
"country_code": "1",
"area_code": "323",
"number": "111-111-1111",
"extension": "105",
"type": "primary"
}
],
"emails": [
{
"id": "123",
"email": "elon@musk.com",
"type": "primary"
}
]
}
],
"fulfillments": [
{
"id": "12345",
"type": "shipment",
"pickup_details": {
"accepted_at": "2020-09-30T07:43:32.000Z",
"auto_complete_duration": "P1W3D",
"cancel_reason": "Not hungry",
"expires_at": "2016-09-04T23:59:33.123Z",
"pickup_at": "2016-09-04T23:59:33.123Z",
"pickup_window_duration": "P1W3D",
"prep_time_duration": "P1W3D",
"note": "Pickup in the back.",
"placed_at": "2016-09-04T23:59:33.123Z",
"rejected_at": "2016-09-04T23:59:33.123Z",
"ready_at": "2016-09-04T23:59:33.123Z",
"expired_at": "2016-09-04T23:59:33.123Z",
"picked_up_at": "2016-09-04T23:59:33.123Z",
"canceled_at": "2016-09-04T23:59:33.123Z",
"curbside_pickup_details": {
"buyer_arrived_at": "2016-09-04T23:59:33.123Z"
},
"recipient": {
"customer_id": "12345",
"display_name": "Elon Musk",
"address": {
"id": "123",
"type": "primary",
"string": "25 Spring Street, Blackburn, VIC 3130",
"name": "HQ US",
"line1": "Main street",
"line2": "apt #",
"line3": "Suite #",
"line4": "delivery instructions",
"line5": "Attention: Finance Dept",
"street_number": "25",
"city": "San Francisco",
"state": "CA",
"postal_code": "94104",
"country": "US",
"latitude": "40.759211",
"longitude": "-73.984638",
"county": "Santa Clara",
"contact_name": "Elon Musk",
"salutation": "Mr",
"phone_number": "111-111-1111",
"fax": "122-111-1111",
"email": "elon@musk.com",
"website": "https://elonmusk.com",
"notes": "Address notes or delivery instructions.",
"row_version": "1-12345"
},
"phone_number": {
"id": "12345",
"country_code": "1",
"area_code": "323",
"number": "111-111-1111",
"extension": "105",
"type": "primary"
},
"email": {
"id": "123",
"email": "elon@musk.com",
"type": "primary"
}
}
}
}
],
"line_items": [
{
"id": "12345",
"name": "New York Strip Steak",
"item": {
"id": "12345"
},
"total_tax": 2000,
"total_discount": 3000,
"total_amount": 27500,
"quantity": 1,
"unit_price": 27500.5,
"applied_taxes": [
{
"id": "12345",
"tax_id": "sales-tax",
"amount": 27500,
"currency": "USD"
}
],
"applied_discounts": [
{
"id": "12345",
"discount_id": "12345",
"amount": 27500,
"currency": "USD"
}
],
"modifiers": [
{
"id": "12345",
"name": "New York Strip Steak - no cheese",
"amount": 27500,
"currency": "USD",
"alternate_name": "Modifier New",
"modifier_group_id": "123"
}
]
}
],
"payments": [
{
"id": "12345",
"amount": 27500,
"currency": "USD"
}
],
"service_charges": [
{
"id": "12345",
"name": "Charge for delivery",
"amount": 27500,
"percentage": 12.5,
"currency": "USD",
"active": true
}
],
"refunds": [
{
"id": "12345",
"location_id": "12345",
"amount": 27500,
"currency": "USD",
"reason": "The reason for the refund being issued.",
"tender_id": "12345",
"transaction_id": "12345"
}
],
"taxes": [
{
"id": "state-sales-tax",
"name": "State Sales Tax",
"amount": 27500,
"currency": "USD",
"percentage": 15,
"auto_applied": true
}
],
"discounts": [
{
"id": "12345",
"product_id": "12345",
"name": "10% off",
"type": "percentage",
"amount": 27500,
"currency": "USD",
"scope": "order"
}
],
"tenders": [
{
"id": "12345",
"name": "10% off",
"type": "cash",
"note": "An optional note associated with the tender at the time of payment.",
"amount": 27500,
"percentage": 10,
"currency": "USD",
"total_amount": 275,
"total_tip": 7,
"total_discount": 3,
"buyer_tendered_cash_amount": 27500,
"change_back_cash_amount": 27500,
"card": {
"id": "12345",
"bin": "41111",
"card_type": "credit",
"prepaid_type": "prepaid",
"cardholder_name": "John Doe",
"customer_id": "12345",
"merchant_id": "12345",
"exp_month": 1,
"exp_year": 2022,
"fingerprint": " Intended as a POS-assigned identifier, based on the card number, to identify the card across multiple locations within a single application.",
"last_4": "The last 4 digits of the card number.",
"enabled": true,
"billing_address": {
"id": "123",
"type": "primary",
"string": "25 Spring Street, Blackburn, VIC 3130",
"name": "HQ US",
"line1": "Main street",
"line2": "apt #",
"line3": "Suite #",
"line4": "delivery instructions",
"line5": "Attention: Finance Dept",
"street_number": "25",
"city": "San Francisco",
"state": "CA",
"postal_code": "94104",
"country": "US",
"latitude": "40.759211",
"longitude": "-73.984638",
"county": "Santa Clara",
"contact_name": "Elon Musk",
"salutation": "Mr",
"phone_number": "111-111-1111",
"fax": "122-111-1111",
"email": "elon@musk.com",
"website": "https://elonmusk.com",
"notes": "Address notes or delivery instructions.",
"row_version": "1-12345"
},
"reference_id": "card-001",
"version": "230320320320"
},
"card_status": "authorized",
"card_entry_method": "swiped",
"payment_id": "12345",
"location_id": "12345",
"transaction_id": "12345"
}
],
"source": "api",
"voided_at": "2020-09-30T07:43:32.000Z",
"version": "230320320320",
"updated_by": "12345",
"created_by": "12345",
"updated_at": "2020-09-30T07:43:32.000Z",
"created_at": "2020-09-30T07:43:32.000Z",
"pass_through": [
{
"extend_paths": [
{
"path": "$.nested.property",
"value": {
"TaxClassificationRef": {
"value": "EUC-99990201-V1-00020000"
}
}
}
]
}
]
}
],
"meta": {
"items_on_page": 50,
"cursors": {
"previous": "em9oby1jcm06OnBhZ2U6OjE=",
"current": "em9oby1jcm06OnBhZ2U6OjI=",
"next": "em9oby1jcm06OnBhZ2U6OjM="
},
"total_count": 1,
"warnings": [
{
"type": "downstream_request_failed",
"status_code": 429,
"operation": "getManager"
}
]
},
"links": {
"previous": "https://unify.apideck.com/crm/companies?cursor=em9oby1jcm06OnBhZ2U6OjE%3D",
"current": "https://unify.apideck.com/crm/companies",
"next": "https://unify.apideck.com/crm/companies?cursor=em9oby1jcm06OnBhZ2U6OjM"
}
}