Search Orders
Search for all Orders
placed through your application given certain filter critera.
This endpoint will only return completed orders by default (no carts). However it is possible to use this endpoint as a "Search Carts" endpoint by combining two parameters.
If you wish to include IN_PROGRESS
orders AKA carts you can set the exclude_in_progress
query param to false
.
If you want to use order search to only search for IN_PROGRESS
orders, that is to say, searching for carts, you can include the the following query in your search body: {"bag_status": "IN_PROGRESS"}
.
You must still set exclude_in_progress
to false in this case.
1
20
false
true
Order Search Request
User ID
Order ID
Referral ID
Bag ID
Bag Status
Merchant ID
Use date_created:max
.
Use date_created:min
.
Order ID in the Channels System
Full customer name to search by - case insensitive.
Customer email to search by - case insensitive.
Name of an Sku present in the order - case insensitive.
Exact total to search.
Order status to search.
Order property to sort by in camel case.
Direction to sort results by.
Only include orders modified after this date.
yyyy-MM-dd'T'HH:mm:ssZ
Only include orders modified before this date.
yyyy-MM-dd'T'HH:mm:ssZ
Only include orders created after this date.
yyyy-MM-dd'T'HH:mm:ssZ
Only include orders created before this date.
yyyy-MM-dd'T'HH:mm:ssZ
Only include orders submitted after this date.
yyyy-MM-dd'T'HH:mm:ssZ
Only include orders submitted before this date.
yyyy-MM-dd'T'HH:mm:ssZ
POST /v1/orders/search HTTP/1.1
Host: sandbox-api.violet.io
X-Violet-Token: text
X-Violet-App-Secret: text
X-Violet-App-Id: 1
Content-Type: application/json
Accept: */*
Content-Length: 554
{
"user_id": 1,
"order_id": 1,
"referral_id": "text",
"bag_id": 1,
"bag_status": "IN_PROGRESS",
"merchant_id": 1,
"app_order_id": "text",
"customer_name": "text",
"customer_email": "text",
"sku_name": "text",
"total": 1,
"status": "IN_PROGRESS",
"sort_by": "text",
"sort_direction": "text",
"date_last_modified:min": "2025-07-10T04:03:12.297Z",
"date_last_modified:max": "2025-07-10T04:03:12.297Z",
"date_created:min": "2025-07-10T04:03:12.297Z",
"date_created:max": "2025-07-10T04:03:12.297Z",
"date_submitted:min": "2025-07-10T04:03:12.297Z",
"date_submitted:max": "2025-07-10T04:03:12.297Z"
}
default response
{
"content": [
{
"id": 1,
"errors": [
{
"id": 1,
"order_id": 1,
"bag_id": 1,
"entity_id": "text",
"entity_type": "ORDER",
"type": "EXTERNAL_CREATE_CART",
"message": "text",
"date_created": "2025-07-10T04:03:12.297Z",
"platform": "OTHER"
}
],
"app_id": 1,
"developer_id": 1,
"customer": {
"first_name": "text",
"last_name": "text",
"email": "text",
"shipping_address": {
"name": "text",
"city": "text",
"state": "text",
"country": "text",
"postal_code": "text",
"phone": "text",
"type": "SHIPPING",
"email": "text",
"address_1": "text",
"address_2": "text",
"first_name": "text",
"last_name": "text"
},
"billing_address": {
"name": "text",
"city": "text",
"state": "text",
"country": "text",
"postal_code": "text",
"phone": "text",
"type": "SHIPPING",
"email": "text",
"address_1": "text",
"address_2": "text",
"first_name": "text",
"last_name": "text"
},
"same_address": false,
"name": "text"
},
"bags": [
{
"id": 1,
"order_id": 1,
"merchant_id": 1,
"app_id": 1,
"external_id": "text",
"external_reference_id": "text",
"status": "IN_PROGRESS",
"fulfillment_status": "PROCESSING",
"financial_status": "UNPAID",
"dispute_status": "UNDISPUTED",
"skus": [
{
"id": 1,
"offer_id": 1,
"merchant_id": 1,
"app_id": 1,
"sku_id": 1,
"external_id": "text",
"name": "text",
"brand": "text",
"thumbnail": "text",
"quantity": 1,
"price": 1,
"weight": 1,
"height": 1,
"width": 1,
"length": 1,
"available": true,
"status": "IN_PROGRESS",
"product_type": "PHYSICAL",
"custom": true,
"custom_properties": [
{
"name": "engraving",
"value": "Happy Birthday!"
}
],
"quantity_fulfilled": 1,
"rates": [
{
"order_sku_id": 1,
"amount": 1,
"rate": 1,
"type": "TAX",
"name": "text",
"decimal_rate": 1,
"dollar_amount": 1
}
],
"line_price": 1
}
],
"shipping_method": {
"type": "CALCULATED",
"Carrier": "OTHER",
"label": "text",
"price": 1,
"custom": true,
"min_subtotal": 1,
"max_subtotal": 1,
"min_weight": 1,
"max_weight": 1,
"external_id": "text",
"id": 1,
"shipping_method_id": "text",
"bag_id": 1,
"merchant_id": 1
},
"taxes": [
{
"order_id": 1,
"merchant_id": 1,
"skus": [
"text"
],
"state": "text",
"postal_code": "text",
"rate": 1,
"amount": 1,
"description": "text"
}
],
"sub_total": 1,
"shipping_total": 1,
"tax_total": 1,
"discount_total": 1,
"total": 1,
"taxes_included": false,
"external_checkout": true,
"commission_rate": 1,
"date_created": "2025-07-10T04:03:12.297Z",
"date_last_modified": "2025-07-10T04:03:12.297Z",
"date_last_consolidated": "2025-07-10T04:03:12.297Z",
"date_submitted": "2025-07-10T04:03:12.297Z",
"remorse_period_ends": "2025-07-10T04:03:12.297Z",
"currency": "text",
"external_currency": "text",
"currency_exchange_rate": 1,
"channel": "APP",
"app_order_id": "text",
"platform": "OTHER",
"fulfillments": [
{
"id": 1,
"bag_id": 1,
"external_id": "text",
"carrier": "OTHER",
"raw_carrier": "text",
"status": "PENDING",
"carrier_status": "PENDING",
"tracking_number": "text",
"tracking_url": "text",
"skus": [
{
"id": 1,
"fulfillment_id": 1,
"order_sku_id": 1,
"quantity_fulfilled": 1
}
]
}
],
"discounts": [
{
"id": 1,
"bag_id": 1,
"status": "PENDING",
"type": "CODE",
"value_type": "AMOUNT",
"target_type": "ORDER",
"code": "text",
"external_id": "text",
"amount": 1,
"percentage": 1,
"amount_total": 1,
"date_created": "2025-07-10T04:03:12.297Z",
"date_last_modified": "2025-07-10T04:03:12.297Z",
"email": "text"
}
],
"wallet_based_checkout": false,
"app_name": "text",
"bag_id": 1,
"bag_status": "IN_PROGRESS",
"merchant_name": "text"
}
],
"shipping_address": {
"name": "text",
"city": "text",
"state": "text",
"country": "text",
"postal_code": "text",
"phone": "text",
"type": "SHIPPING",
"email": "text",
"address_1": "text",
"address_2": "text",
"first_name": "text",
"last_name": "text"
},
"billing_address": {
"name": "text",
"city": "text",
"state": "text",
"country": "text",
"postal_code": "text",
"phone": "text",
"type": "SHIPPING",
"email": "text",
"address_1": "text",
"address_2": "text",
"first_name": "text",
"last_name": "text"
},
"payment_method": {
"brand": "text",
"last_four": "text",
"exp_month": 1,
"exp_year": 1,
"cardholder_name": "text",
"payment_method_id": 1,
"default": true
},
"sub_total": 0,
"shipping_total": 0,
"tax_total": 0,
"discount_total": 0,
"total": 0,
"app_customer_id": "text",
"app_order_id": "text",
"status": "IN_PROGRESS",
"is_guest": true,
"date_created": "2025-07-10T04:03:12.297Z",
"date_last_modified": "2025-07-10T04:03:12.297Z",
"date_submitted": "2025-07-10T04:03:12.297Z",
"priced": false,
"wallet_based_checkout": false,
"currency": "USD",
"referral_id": "text",
"currency_symbol": "text",
"app_name": "text",
"stripe_key": "text",
"payment_intent_client_secret": "text",
"payment_transactions": [
{
"id": 1,
"order_id": 1,
"payment_provider": "text",
"payment_provider_transaction_id": "text",
"payment_method_id": 1,
"payment_provider_payment_method_id": "text",
"payment_intent_client_secret": "text",
"amount": 1,
"currency": "text",
"capture_status": "PROCESSING",
"capture_method": "AUTOMATIC",
"transfer_status": "SENT",
"transfer_method": "AUTOMATIC",
"metadata": {
"ANY_ADDITIONAL_PROPERTY": {}
},
"related_bags": [
"text"
],
"related_refunds": [
"text"
],
"errors": [
{
"id": 1,
"error_code": 1,
"error_message": "text",
"resolved": true,
"date_resolved": "2025-07-10T04:03:12.297Z",
"date_created": "2025-07-10T04:03:12.297Z",
"payment_transaction_id": 1
}
],
"date_created": "2025-07-10T04:03:12.297Z",
"date_last_modified": "2025-07-10T04:03:12.297Z",
"status": "PROCESSING"
}
],
"order_id": 1,
"guest": true,
"order_status": "IN_PROGRESS",
"intent_based_checkout": true
}
],
"last": true,
"total_pages": 1,
"total_elements": 1,
"first": true,
"number_of_elements": 1,
"size": 1,
"number": 1,
"empty": true,
"next_page_cursor": "text",
"pageable": {
"page_number": 1,
"page_size": 1,
"sort": {
"unsorted": true,
"sorted": true,
"empty": true
},
"offset": 1,
"paged": true,
"unpaged": true
},
"sort": {
"unsorted": true,
"sorted": true,
"empty": true
}
}
Last updated
Was this helpful?