Get All Orders - Trackstar

GET

wms

orders

page_token

string

created_date

string

created_date[eq]

string

created_date[neq]

string

created_date[gt]

string

created_date[gte]

string

created_date[lt]

string

created_date[lte]

string

created_date[in]

array

created_date[nin]

array

updated_date

string

updated_date[eq]

string

updated_date[neq]

string

updated_date[gt]

string

updated_date[gte]

string

updated_date[lt]

string

updated_date[lte]

string

updated_date[in]

array

updated_date[nin]

array

limit

integer

ids

string

ids[in]

array

status

enum<string>

status[eq]

enum<string>

status[neq]

enum<string>

status[in]

array

status[nin]

array

warehouse_customer_id

string

warehouse_customer_id[eq]

string

warehouse_customer_id[neq]

string

warehouse_customer_id[in]

array

warehouse_customer_id[nin]

array

channel

string

channel[eq]

string

channel[neq]

string

channel[in]

array

channel[nin]

array

type

enum<string>

type[eq]

enum<string>

type[neq]

enum<string>

type[in]

array

type[nin]

array

order_number

string

order_number[eq]

string

order_number[in]

array

order_number[nin]

array

reference_id

string

reference_id[eq]

string

reference_id[in]

array

reference_id[nin]

array

required_ship_date

string

required_ship_date[eq]

string

required_ship_date[neq]

string

required_ship_date[gt]

string

required_ship_date[gte]

string

required_ship_date[lt]

string

required_ship_date[lte]

string

Headers

x-trackstar-api-key

string

required

Your organization-level Trackstar API key.

x-trackstar-access-token

string

required

Your user's access token for a specific integration (ShipHero, Extensiv, etc).

Query Parameters

page_token

string | null

The page token to use to retrieve the next page of results. If this field is omitted, there are no subsequent pages.

created_date

string

Use this parameter to retrieve items filtered to a specific date range. For example, to get all items between 2023-03-10 and 2023-03-22, you would send created_date[gt]=2023-03-10T00:00:00Z&created_date[lt]=2023-03-22T00:00:00Z. See the filtering docs for more. The date format must always be YYYY-MM-DDTHH:MM:SSZ.

created_date[eq]

string

created_date[neq]

string

created_date[gt]

string

created_date[gte]

string

created_date[lt]

string

created_date[lte]

string

created_date[in]

string[]

Comma-separated.

created_date[nin]

string[]

Comma-separated.

updated_date

string

Same syntax as created_date.

updated_date[eq]

string

updated_date[neq]

string

updated_date[gt]

string

updated_date[gte]

string

updated_date[lt]

string

updated_date[lte]

string

updated_date[in]

string[]

Comma-separated.

updated_date[nin]

string[]

Comma-separated.

limit

integer

The maximum number of items to return. The default is 1000.

ids

string

A comma separated list of resource Ids. If provided, all other query params are ignored.

ids[in]

string[]

Comma-separated.

status

enum<string>

The status of the order. See the order information for more details.

Available options:

open,

confirmed,

processing,

picked,

packed,

partially_fulfilled,

fulfilled,

exception,

cancelled,

backordered,

other

status[eq]

enum<string>

Available options:

open,

confirmed,

processing,

picked,

packed,

partially_fulfilled,

fulfilled,

exception,

cancelled,

backordered,

other

status[neq]

enum<string>

Available options:

open,

confirmed,

processing,

picked,

packed,

partially_fulfilled,

fulfilled,

exception,

cancelled,

backordered,

other

status[in]

enum<string>[]

Comma-separated.

Available options:

open,

confirmed,

processing,

picked,

packed,

partially_fulfilled,

fulfilled,

exception,

cancelled,

backordered,

other

status[nin]

enum<string>[]

Comma-separated.

Available options:

open,

confirmed,

processing,

picked,

packed,

partially_fulfilled,

fulfilled,

exception,

cancelled,

backordered,

other

warehouse_customer_id

string

The ID of the customer associated with the resource

warehouse_customer_id[eq]

string

warehouse_customer_id[neq]

string

warehouse_customer_id[in]

string[]

Comma-separated.

warehouse_customer_id[nin]

string[]

Comma-separated.

channel

string

The channel the order was placed on

channel[eq]

string

channel[neq]

string

channel[in]

string[]

Comma-separated.

channel[nin]

string[]

Comma-separated.

type

enum<string>

The type of order: d2c, b2b, or dropship

Available options:

d2c,

b2b,

dropship

type[eq]

enum<string>

Available options:

d2c,

b2b,

dropship

type[neq]

enum<string>

Available options:

d2c,

b2b,

dropship

type[in]

enum<string>[]

Comma-separated.

Available options:

d2c,

b2b,

dropship

type[nin]

enum<string>[]

Comma-separated.

Available options:

d2c,

b2b,

dropship

order_number

string

A user-friendly identifier for the order

order_number[eq]

string

order_number[in]

string[]

Comma-separated.

order_number[nin]

string[]

Comma-separated.

reference_id

string

An external unique identifier for the order

reference_id[eq]

string

reference_id[in]

string[]

Comma-separated.

reference_id[nin]

string[]

Comma-separated.

required_ship_date

string

The date the order must be shipped by. Same query syntax as created_date/updated_date

required_ship_date[eq]

string

required_ship_date[neq]

string

required_ship_date[gt]

string

required_ship_date[gte]

string

required_ship_date[lt]

string

required_ship_date[lte]

string

Response

200 - application/json

data

object[]

data.id

string

The unique ID of the order.

data.warehouse_customer_id

string | null

The ID of the merchant/tenant/customer that owns the order. Can be passed into the Warehouse Customer endpoint for more details.

data.warehouse_id

string | null

If set at the order level, the expected warehouse the order will be shipped from. At the shipment level, the warehouse the shipment was shipped from. Can be passed into the Warehouse endpoint for more details.

data.created_date

string

The date the order was created.

data.updated_date

string

The date the order was last updated.

data.reference_id

string

An external unique identifier for the order, such as a Shopify order id. Defaults to id if client has not defined one.

data.order_number

string

A user-friendly identifier for their order. Defaults to reference_id if not provided.

data.status

enum<string>

The status of the order. See the order information for more details.

Available options:

open,

confirmed,

processing,

picked,

packed,

partially_fulfilled,

fulfilled,

exception,

cancelled,

backordered,

other

data.raw_status

string | null

The raw status (if available) returned directly from the WMS.

data.channel

string | null

Deprecated in favor of channel_object.

data.channel_object

object | null

data.type

enum<string> | null

The type of order, such as d2c or b2b.

Available options:

d2c,

b2b,

dropship

data.trading_partner

string | null

For retail/EDI orders, the trading partner who placed the order (e.g. Target, Walmart).

data.shipping_method

string | null

The method by which the warehouse will ship the order to the customer. Can be passed into the Shipping Method endpoint for more details.

data.is_third_party_freight

boolean | null

True if the order was shipped using a third party freight account.

data.invoice_currency_code

string

The currency used for this order. If not provided explicitly, defaults to USD.

data.total_price

number | null

The total price a customer paid for the order.

data.total_tax

number | null

The total tax on the order.

data.total_discount

number | null

The total amount discounted from the order.

data.total_shipping

number | null

The total shipping cost for the order incurred by the customer.

data.ship_to_address

object

data.line_items

object[]

List of the products included in the order.

data.tags

string[]

A list of tags associated with the order. Tags that are represented as key-value pairs in the WMS will be represented as a single string formatted as key:value.

data.required_ship_date

string | null

The date the order must be shipped by.

data.shipments

object[]

List of the shipments sent out to the customer.

data.shipments.shipment_id

string

required

The ID of the shipment.

data.shipments.warehouse_id

string

required

The warehouse this order was shipped from. Can be passed into the Warehouse endpoint for more details.

data.shipments.raw_status

string | null

required

The raw status (if available) of the shipment returned directly from the WMS.

data.shipments.status

enum<string>

required

The status of the shipment.

Available options:

open,

shipped,

cancelled,

other

data.shipments.shipped_date

string

required

The date the shipment was sent.

data.shipments.shipping_method

string | null

required

The method by which the warehouse will ship the order to the customer. Can be passed into the Shipping Method endpoint for more details.

data.shipments.line_items

object[]

required

List of the inventory items listed in the shipment.

data.shipments.ship_to_address

object

required

data.shipments.ship_from_address

object

required

data.shipments.packages

object[]

required

A list of the packages included in the shipment.

data.shipments.packages.package_id

string

required

The ID of the package.

data.shipments.packages.package_name

string | null

required

The name of the package. (e.g. 12x9x4)

data.shipments.packages.tracking_number

string | null

required

The tracking number for the package.

data.shipments.packages.tracking_url

string | null

required

The URL for the tracking number.

data.shipments.packages.shipping_method

string | null

required

The method by which the warehouse will ship the order to the customer. Can be passed into the Shipping Method endpoint for more details.

data.shipments.packages.carrier

string | null

required

The carrier used to ship the package.

data.shipments.packages.scac

string | null

required

The Standard Carrier Alpha Code for the carrier used to ship the package.

data.shipments.packages.shipping_cost

number | null

required

The cost incurred by the warehouse to ship the package.

data.shipments.packages.measurements

object

required

data.shipments.packages.line_items

object[]

required

A list of the inventory items included in the package.

data.external_system_url

string | null

URL link to the order in the external system (WMS/Freight etc).

data.trackstar_tags

any[] | null

A list of custom tags associated with the order. A tag can be either a string or a dictionary with one key-value pair. e.g. ['tag1', 'tag2', {'key1': 'value1'}]

next_token

string | null

See pagination for more details.

total_count

integer

The number of items returned.

Orders Get Order

API Documentation

Headers

Query Parameters

Response