Shipments

Get Shipments

Retrieve a list of shipments for the specified shipping location in a given time period. With this endpoint, you can filter and view details of your shipments based on various criteria, such as status, date ranges, and other parameters.

get/v4/shipments/{shippingLocationId}

Path parameters

shippingLocationIdstring required

A unique identifier for the shipping location assigned by the system or by you (alias), allowing users to reference and manage specific locations effectively. <br /> <br />Note: To get the shipments for a particular shipping location, you can filter this value by the shipping location ID. If the ShippingLocationId is not provided, then the response will return shipments for all shipping locations.

Query parameters

shippingAccountIdstring

A unique identifier for each shipping account assigned by the system or you (alias), allowing for efficient reference and management of individual accounts within the system. <br /> <br />Note: To get the shipments for a particular shipping account, you can filter this value by the shipping account ID. If the ShippingAccountId is not provided, then the response will return shipments for all shipping accounts.

carrierCodestring

A unique identifier for the carrier associated with the shipping account. This code is typically alphanumeric and helps in identifying the specific carrier linked to the shipping account. <br /> <br />Note: If both the shipping account ID and the carrier code are provided, then the value sent in the carrierCode field is ignored and the carrier associated with the shipping account is used instead.

status'Created' | 'OnHold' | 'Cancelled' | 'ReadyToPrint' | 'LabelPrinted' | 'Confirmed' | 'Picked'

Get Shipments Status Type

Indicates the current state of a shipment. You can filter your shipments using any of the following statuses: <br />Created: The shipment has been initiated but not processed. <br />OnHold: The shipment is temporarily paused for various reasons. <br />Cancelled: The shipment has been cancelled and will not proceed. <br />ReadyToPrint: The shipment is prepared for label printing. <br />LabelPrinted: The shipping label has been generated and printed. <br />Confirmed: The shipment has been confirmed and is set for processing. <br />Picked: The package has been picked up for delivery.

destinationCountryCodestring

An abbreviation representing the destination country for the shipment, following the ISO 3166-1 alpha-2 standard, for example, "GB" for the United Kingdom.

dateFromstring date

A timestamp indicating the start date for filtering shipments in the query. This helps users retrieve shipments created or processed after this specified date. <br /> <br />Note: The date must be in the YYYY-MM-DD format. If the date is not provided, then the value in this field defaults to the current (today's) date.

dateTostring date

A timestamp indicating the end date for filtering shipments in the query. This allows users to view shipments processed up to this specified date. <br /> <br />Note: The date must be in the YYYY-MM-DD format. If the date is not provided, then the value in this field defaults to the current (today's) date.

pageSizeinteger

An integer that defines the number of shipments returned per page in the response. For instance, if pageSize is set to 20, the API will return up to 20 shipments in each response. <br /> <br />Note: By default, this value is set to 100.

pageNumberinteger

An integer indicating the specific page of results to retrieve, allowing for pagination of larger datasets. For example, if pageNumber is set to 3, the API will return the results corresponding to the third page of shipments based on the specified pageSize. <br /> <br />Note: By default, this value is set to 1.

Response

Returns a list of shipments.

TotalCountinteger required

An integer representing the total number of shipments that match the specified query criteria. This provides users with an overview of how many shipments are available on the system, enabling better understanding of the dataset.

Example response

{
  "TotalCount": 32
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.