- Get API Keys
- Welcome
Access
Offers
SKUs
Categories
Collections
Currencies
Cart
Payment
Customer
Completion
Shipping
Discounts
Items
Refunds
Orders
Merchant
Configuration
Explore
Webhooks
Webhook Events
Wekbhook Headers
Merchant/App Installs
Connection
Shipping
Overview
Login
Catalog
Orders & Checkout
Merchants
Events
Apps
Operations
Relay
Search Bags
Bag Search Request
Merchant ID
Order ID
Bag ID
Bag External ID
Bag Status
Order ID in the Channels System
Before date last modified
After date last modified
Before date last created
After date last created
Property to sort by in camelCase
Direction to sort by
curl --request POST \
--url https://sandbox-api.violet.io/v1/orders/bags/search \
--header 'Content-Type: application/json' \
--data '{
"merchant_id": 123,
"order_id": 123,
"id": 123,
"external_id": "<string>",
"bag_status": "IN_PROGRESS",
"app_order_id": "<string>",
"before_date": "2023-11-07T05:31:56Z",
"after_date": "2023-11-07T05:31:56Z",
"before_date_created": "2023-11-07T05:31:56Z",
"after_date_created": "2023-11-07T05:31:56Z",
"sort_by": "<string>",
"sort_direction": "<string>"
}'
{
"content": [
{
"id": 123,
"order_id": 123,
"merchant_id": 123,
"app_id": 123,
"external_id": "<string>",
"status": "IN_PROGRESS",
"fulfillment_status": "PROCESSING",
"financial_status": "UNPAID",
"skus": [
{
"id": 123,
"merchant_id": 123,
"app_id": 123,
"product_id": "<string>",
"sku_id": 123,
"external_id": "<string>",
"name": "<string>",
"brand": "<string>",
"thumbnail": "<string>",
"quantity": 123,
"price": 123,
"weight": 123,
"height": 123,
"width": 123,
"length": 123,
"available": true,
"status": "IN_PROGRESS",
"product_type": "PHYSICAL",
"custom": true,
"CustomProperties": [
{
"name": "engraving",
"value": "Happy Birthday!"
}
],
"quantity_fulfilled": 123,
"order_sku_rates": [
{
"order_sku_id": 123,
"amount": 123,
"rate": 123,
"type": "TAX",
"name": "<string>",
"decimal_rate": 123,
"dollar_amount": 123
}
],
"line_price": 123
}
],
"shipping_method": {
"type": "CALCULATED",
"Carrier": "OTHER",
"label": "<string>",
"price": 123,
"custom": true,
"min_subtotal": 123,
"max_subtotal": 123,
"min_weight": 123,
"max_weight": 123,
"external_id": "<string>",
"id": 123,
"shipping_method_id": "<string>",
"bag_id": 123,
"merchant_id": 123,
"tracking_number": "<string>"
},
"taxes": [
{
"order_id": 123,
"merchant_id": 123,
"skus": [
"<string>"
],
"state": "<string>",
"postal_code": "<string>",
"rate": 123,
"amount": 123,
"description": "<string>"
}
],
"sub_total": 123,
"shipping_total": 123,
"tax_total": 123,
"discount_total": 123,
"total": 123,
"taxes_included": true,
"transactions": [
{
"id": 123,
"merchant_id": 123,
"app_id": 123,
"order_id": 123,
"bag_id": 123,
"payment_method_id": 123,
"gateway_transaction_id": "<string>",
"gateway": "<string>",
"amount": 123,
"currency": "<string>",
"type": "AUTHORIZATION",
"error_code": "<string>",
"status": "PROCESSING",
"test": true,
"date_created": "2023-11-07T05:31:56Z",
"date_last_modified": "2023-11-07T05:31:56Z",
"order_payment_method": {
"brand": "<string>",
"last_four": "<string>",
"exp_month": 123,
"exp_year": 123,
"cardholder_name": "<string>",
"payment_method_id": 123,
"default": true
}
}
],
"external_checkout": true,
"commission_rate": 123,
"date_created": "2023-11-07T05:31:56Z",
"date_last_modified": "2023-11-07T05:31:56Z",
"date_last_consolidated": "2023-11-07T05:31:56Z",
"remorse_period_ends": "2023-11-07T05:31:56Z",
"currency": "<string>",
"external_currency": "<string>",
"currency_exchange_rate": 123,
"channel": "APP",
"app_order_id": "<string>",
"platform": "OTHER",
"fulfillments": [
{
"id": 123,
"bag_id": 123,
"external_id": "<string>",
"carrier": "OTHER",
"raw_carrier": "<string>",
"status": "PENDING",
"carrier_status": "PENDING",
"tracking_number": "<string>",
"tracking_url": "<string>",
"skus": [
{
"id": 123,
"fulfillment_id": 123,
"order_sku_id": 123,
"quantity_fulfilled": 123
}
]
}
],
"discounts": [
{
"id": 123,
"bag_id": 123,
"status": "PENDING",
"type": "CODE",
"value_type": "AMOUNT",
"target_type": "ORDER",
"code": "<string>",
"external_id": "<string>",
"amount": 123,
"percentage": 123,
"amount_total": 123,
"date_created": "2023-11-07T05:31:56Z",
"date_last_modified": "2023-11-07T05:31:56Z"
}
],
"wallet_based_checkout": true,
"app_name": "<string>",
"bag_id": 123,
"bag_status": "IN_PROGRESS",
"merchant_name": "<string>"
}
],
"last": true,
"total_pages": 123,
"total_elements": 123,
"first": true,
"number_of_elements": 123,
"size": 123,
"number": 123,
"empty": true,
"next_page_cursor": "<string>",
"pageable": {
"page_number": 123,
"page_size": 123,
"sort": {
"unsorted": true,
"sorted": true,
"empty": true
},
"offset": 123,
"paged": true,
"unpaged": true
},
"sort": {
"unsorted": true,
"sorted": true,
"empty": true
}
}
Search for all Bags
placed through your application given certain filter critera.
Headers
Query Parameters
Body
Merchant ID
Order ID
Bag ID
Bag External ID
Bag Status
IN_PROGRESS
, SUBMITTED
, ACCEPTED
, COMPLETED
, PARTIALLY_REFUNDED
, REFUNDED
, REJECTED
, CANCELED
, BACKORDERED
Order ID in the Channels System
Before date last modified
After date last modified
Before date last created
After date last created
Property to sort by in camelCase
Direction to sort by
Response
The actual content of the response; A list of the result objects
ID of the Order the Bag belongs to
ID of the Merchant the Bag references
ID of the App creating this Bag
ID of the Order on the External Ecommerce Platform
Status
IN_PROGRESS
, SUBMITTED
, ACCEPTED
, COMPLETED
, PARTIALLY_REFUNDED
, REFUNDED
, REJECTED
, CANCELED
, BACKORDERED
Fulfillment Status
PROCESSING
, SHIPPED
, PARTIALLY_SHIPPED
, DELIVERED
, COULD_NOT_DELIVER
, RETURNED
Financial Status
UNPAID
, AUTHORIZED
, PENDING
, PAID
, PARTIALLY_PAID
, REFUNDED
, PARTIALLY_REFUNDED
, VOIDED
SKUs added to the bag
ID of the Merchant the SKU belongs to
ID of the App creating the Order
ID of the Product
ID of the referenced SKU
ID of the SKU on the External Ecommerce Platform
Name of the SKU
Brand Name
URL of the thumbnail image. Useful for order overview displays
Quantity of the SKU being purchased. Quantities over 1000 will default to 1000
Price of the individual SKU. In Cents
Weight of SKU
Height of SKU
Width of SKU
Length of SKU
Is the product still available for purchase. If a SKU becomes unavailable it likely means that the product became out of stock after it was added to the cart. Unavailable SKUs cannot be purchased.
Sku Status
IN_PROGRESS
, PROCESSING
, SHIPPED
, PARTIALLY_SHIPPED
, DELIVERED
, COULD_NOT_DELIVER
, RETURNED
, CANCELED
, REFUNDED
, ERROR
, PARTIALLY_RETURNED
, PARTIALLY_REFUNDED
Product Type
PHYSICAL
, DIGITAL
, VIRTUAL
, BUNDLED
Is the Sku custom. True when the price has been overridden.
Used to provide the merchant with custom values for the product. This functionality is currently limited to Shopify merchants.
Name of the custom property.
Value of the custom property.
The quantity of this item that has been fulfilled
ID of the Order SKU the Rate belongs to
Total Tax amount on Bag. In Cents
Rate
Rate Type
TAX
, SHIPPING
, FEE
, DUTY
Rate Name
Price of the SKU multiplied by the Quantity. In Cents
Shipping Methods belonging to an Order
Type of Shipping Method
CALCULATED
, FLAT_RATE_PRICE
, FLAT_RATE_WEIGHT
OTHER
, UPS
, USPS
, FEDEX
, DHL
, ONTRAC
, ROYAL_MAIL
, SENDLE
, POSTNORD
Shipping Method Label
Total cost of the Shipping Method. In Cents
Is the shipping method custom. True when the price has been overridden.
Minimum Subtotal. In Cents. Only applies to Flat Rate by Price
Maximum Subtotal. In Cents. Only applies to Flat Rate by Price
Minimum Weight. In Cents. Only applies to Flat Rate by Weight
Maximum Weight. In Cents. Only applies to Flat Rate by Weight
ID(s) on external ecommerce platform
ID of the referenced Shipping Method
ID of the Bag the Shipping Method applies to
ID of the merchant the bag belongs to
Carrier Tracking Number
Taxes applied to the bag
ID of the Order the Tax belongs to
ID of the Merchant the Bag belongs to
SKUs covered by the Tax
State abbreviation
Postal/Zip Code
Tax Rate
Total Tax amount on Bag. In Cents
Description of the Tax
The price of the Bag in the base currency before discounts, shipping, duties, taxes, and tips. In Cents
The sum of all shipping methods applied to the Bag in the base currency. In Cents
The sum of all the taxes applied to the Bag in the base currency. In Cents
The total discounts applied to the price of the Bag in the base currency. In Cents
The sum of all item prices, discounts, shipping, and taxes applied to the Bag in the base currency. In Cents
Are taxes included in the cart total.
Transactions of the bag
ID of the Merchant receiving the transaction
ID of the App that created the Order
ID of the Order the Transaction applies to
ID of the Bag the Transaction applies to
ID of the referenced Payment Method
ID of the Transaction in the Payment Gateway
Gateway processing the Transaction
Total amount being transacted
Currency the Transaction takes place in
Transaction Type
AUTHORIZATION
, CAPTURE
, SALE
, VOID
, REFUND
Error Code from gateway if error occurred
Transaction Status
PROCESSING
, COMPLETED
, REFUNDED
, REQUIRES_ACTION
Is this a test Transaction
Date of transaction creation
Date of last transaction update
Payment Method belonging to an Order
Brand of Card
Last Four Numbers on Card
Card Expiration Month
Card Expiration Year
Name as it appears on Card
ID of the referenced Payment Method
Is Default Method
If bag is tracked externally
The developer commission rate
Date of creation
Date of last update
Date of last consolidation
Date when the bag can no longer be refunded
Base currency of cart
Currency of cart on external ecommerce platform
Exchange rate of currency and external currency, if different, at the time the bag was last priced.
The channel that originated this order.
APP
, MARKETPLACE
, FACEBOOK
, INSTAGRAM
, WALMART
, GOOGLE
, TIKTOK
, SNAPCHAT
, PINTEREST
App Order ID. Automatically obtained through the app_order_id applied to the order.
The commerce platform used by this merchant.
OTHER
, SHOPIFY
, MAGENTO
, MAGENTO_ONE
, WOOCOMMERCE
, BIGCOMMERCE
, LIGHTSPEED
, ECWID
, YAAS
, SPREECOMMERCE
, DEMANDWARE
, VOLUSION
, PRESTASHOP
, THREEDCART
, SYLIUS
, WIX
, SWELL
, MIVA
, WEBSPHERE
, ORACLECC
, SAPCC
, SQUARESPACE
, SHOPWARE
, COMMERCETOOLS
, MEDUSA
, ABICART
, SPRYKER
, MYSTORE
, CENTRA
, XCART
, VTEX
, KIBO
, SALEOR
, VENDO
, CHORD
, DIGITALRIVER
, SQUARE
, AMAZON
, BIGCARTEL
, CUSTOM
ID of the bag the fulfillment belongs to.
ID of the fulfillment on the external commerce platform.
Carrier responsible for the fulfillment. Will be OTHER if raw carrier is not recognized.
OTHER
, UPS
, USPS
, FEDEX
, DHL
, ONTRAC
, ROYAL_MAIL
, SENDLE
, POSTNORD
Raw name of carrier from the external commerce platform.
ID of the Bag the fulfillment belongs to.
PENDING
, PROCESSING
, SUCCESS
, CANCELED
, ERROR
, FAILURE
, NONE_PROVIDED
ID of the Bag the fulfillment belongs to.
PENDING
, LABEL_PURCHASED
, LABEL_PRINTED
, CONFIRMED
, READY_FOR_PICKUP
, IN_TRANSIT
, OUT_FOR_DELIVERY
, ATTEMPTED_DELIVERY
, DELIVERED
, FAILURE
, NONE_PROVIDED
Tracking number provider by the carrier.
Tracking URL provider by the carrier.
SKUs fulfilled by this fulfillment.
ID of the fulfillment that contains this item.
ID of the SKU in the Bag.
Quantity of the this item fulfilled by this fulfillment.
ID of the Bag this discount belong to
Status of discount
PENDING
, APPLIED
, INVALID
, NOT_SUPPORTED
, ERROR
, EXPIRED
Type of discount
CODE
Value type of discount
AMOUNT
, PERCENTAGE
Target type of the discount
ORDER
, SKU
, SHIPPING
Code of discount
External ID of discount
Amount of discount
Percentage of discount
Total amount of discount applied to bag
Date of creation
Date of last bag discount update
Is this bag going to be placed through wallet-based checkout
Name of app that originated the order. Use the "extended" query param when looking up orders to include this value.
IN_PROGRESS
, SUBMITTED
, ACCEPTED
, COMPLETED
, PARTIALLY_REFUNDED
, REFUNDED
, REJECTED
, CANCELED
, BACKORDERED
Name of Merchant
Boolean indicating if this is the last page
The total count of pages available
The total count of objects available
Boolean indicating if this is the first page of the response
The total number of objects in this specific response
The page size selected at request time
The page number selected at request time
Boolean indicating if the response content is empty
Contains the cursor for the next page. This property will only be used for situations where the API does not support the page number/page size paradigm and it will mutually exclusive with the size/number fields in the response. If this property is returned it must be passed when requesting the next page from the API. Does not apply to endpoints that do not have a next_page_cursor query param documented.
Violet wrapper for springframework pageable
The current page number (one based)
The number of elements per page
Violet Wrapper for springframework sort
Boolean indicating if the result set is unsorted
Boolean indicating if the result set is sorted
Boolean indicating if the result set is empty
The offset
Boolean indicating if the result is paged
Boolean indicating if the result is unpaged
Violet Wrapper for springframework sort
Boolean indicating if the result set is unsorted
Boolean indicating if the result set is sorted
Boolean indicating if the result set is empty
Was this page helpful?
curl --request POST \
--url https://sandbox-api.violet.io/v1/orders/bags/search \
--header 'Content-Type: application/json' \
--data '{
"merchant_id": 123,
"order_id": 123,
"id": 123,
"external_id": "<string>",
"bag_status": "IN_PROGRESS",
"app_order_id": "<string>",
"before_date": "2023-11-07T05:31:56Z",
"after_date": "2023-11-07T05:31:56Z",
"before_date_created": "2023-11-07T05:31:56Z",
"after_date_created": "2023-11-07T05:31:56Z",
"sort_by": "<string>",
"sort_direction": "<string>"
}'
{
"content": [
{
"id": 123,
"order_id": 123,
"merchant_id": 123,
"app_id": 123,
"external_id": "<string>",
"status": "IN_PROGRESS",
"fulfillment_status": "PROCESSING",
"financial_status": "UNPAID",
"skus": [
{
"id": 123,
"merchant_id": 123,
"app_id": 123,
"product_id": "<string>",
"sku_id": 123,
"external_id": "<string>",
"name": "<string>",
"brand": "<string>",
"thumbnail": "<string>",
"quantity": 123,
"price": 123,
"weight": 123,
"height": 123,
"width": 123,
"length": 123,
"available": true,
"status": "IN_PROGRESS",
"product_type": "PHYSICAL",
"custom": true,
"CustomProperties": [
{
"name": "engraving",
"value": "Happy Birthday!"
}
],
"quantity_fulfilled": 123,
"order_sku_rates": [
{
"order_sku_id": 123,
"amount": 123,
"rate": 123,
"type": "TAX",
"name": "<string>",
"decimal_rate": 123,
"dollar_amount": 123
}
],
"line_price": 123
}
],
"shipping_method": {
"type": "CALCULATED",
"Carrier": "OTHER",
"label": "<string>",
"price": 123,
"custom": true,
"min_subtotal": 123,
"max_subtotal": 123,
"min_weight": 123,
"max_weight": 123,
"external_id": "<string>",
"id": 123,
"shipping_method_id": "<string>",
"bag_id": 123,
"merchant_id": 123,
"tracking_number": "<string>"
},
"taxes": [
{
"order_id": 123,
"merchant_id": 123,
"skus": [
"<string>"
],
"state": "<string>",
"postal_code": "<string>",
"rate": 123,
"amount": 123,
"description": "<string>"
}
],
"sub_total": 123,
"shipping_total": 123,
"tax_total": 123,
"discount_total": 123,
"total": 123,
"taxes_included": true,
"transactions": [
{
"id": 123,
"merchant_id": 123,
"app_id": 123,
"order_id": 123,
"bag_id": 123,
"payment_method_id": 123,
"gateway_transaction_id": "<string>",
"gateway": "<string>",
"amount": 123,
"currency": "<string>",
"type": "AUTHORIZATION",
"error_code": "<string>",
"status": "PROCESSING",
"test": true,
"date_created": "2023-11-07T05:31:56Z",
"date_last_modified": "2023-11-07T05:31:56Z",
"order_payment_method": {
"brand": "<string>",
"last_four": "<string>",
"exp_month": 123,
"exp_year": 123,
"cardholder_name": "<string>",
"payment_method_id": 123,
"default": true
}
}
],
"external_checkout": true,
"commission_rate": 123,
"date_created": "2023-11-07T05:31:56Z",
"date_last_modified": "2023-11-07T05:31:56Z",
"date_last_consolidated": "2023-11-07T05:31:56Z",
"remorse_period_ends": "2023-11-07T05:31:56Z",
"currency": "<string>",
"external_currency": "<string>",
"currency_exchange_rate": 123,
"channel": "APP",
"app_order_id": "<string>",
"platform": "OTHER",
"fulfillments": [
{
"id": 123,
"bag_id": 123,
"external_id": "<string>",
"carrier": "OTHER",
"raw_carrier": "<string>",
"status": "PENDING",
"carrier_status": "PENDING",
"tracking_number": "<string>",
"tracking_url": "<string>",
"skus": [
{
"id": 123,
"fulfillment_id": 123,
"order_sku_id": 123,
"quantity_fulfilled": 123
}
]
}
],
"discounts": [
{
"id": 123,
"bag_id": 123,
"status": "PENDING",
"type": "CODE",
"value_type": "AMOUNT",
"target_type": "ORDER",
"code": "<string>",
"external_id": "<string>",
"amount": 123,
"percentage": 123,
"amount_total": 123,
"date_created": "2023-11-07T05:31:56Z",
"date_last_modified": "2023-11-07T05:31:56Z"
}
],
"wallet_based_checkout": true,
"app_name": "<string>",
"bag_id": 123,
"bag_status": "IN_PROGRESS",
"merchant_name": "<string>"
}
],
"last": true,
"total_pages": 123,
"total_elements": 123,
"first": true,
"number_of_elements": 123,
"size": 123,
"number": 123,
"empty": true,
"next_page_cursor": "<string>",
"pageable": {
"page_number": 123,
"page_size": 123,
"sort": {
"unsorted": true,
"sorted": true,
"empty": true
},
"offset": 123,
"paged": true,
"unpaged": true
},
"sort": {
"unsorted": true,
"sorted": true,
"empty": true
}
}