Get old shipments

Request

Query Params

queryType

required

SHIPMENT or DATE_RANGE or NEXT_TOKEN. Indicates whether shipments are returned using shipment information (by providing the ShipmentStatusList or ShipmentIdList parameters), using a date range (by providing the LastUpdatedAfter and LastUpdatedBefore parameters), or by using NextToken to continue returning items specified in a previous request.

Example:

SHIPMENT

shipmentStatusList

optional

A list of ShipmentStatus values. Used to select shipments with a current status that matches the status values that you specify.

Example:

WORKING,READY_TO_SHIP,SHIPPED,RECEIVING,CANCELLED,DELETED,CLOSED,ERROR,IN_TRANSIT,DELIVERED,CHECKED_IN

shipmentIdList

optional

A list of shipment IDs used to select the shipments that you want. If both ShipmentStatusList and ShipmentIdList are specified, only shipments that match both parameters are returned.

Example:

FBA18VL7CBZ0,FBA18XW7GGHW

lastUpdatedBefore

optional

A date used for selecting inbound shipments that were last updated before (or at) a specified time. The selection includes updates made by Amazon and by the seller.

Example:

2025-06-01

lastUpdatedAfter

optional

A date used for selecting inbound shipments that were last updated after (or at) a specified time. The selection includes updates made by Amazon and by the seller.

Example:

2025-01-01

nextToken

optional

A string token returned in the response to your previous request.

domain

optional

Amazon marketplace domain. Domain amazon.com is used by default if domain and marketplaceId are not provided. If both domain and marketplaceId are chosen, domain has bigger priority. Options: amazon.com, amazon.ca, amazon.co.uk, amazon.de, amazon.es, amazon.it, amazon.fr, amazon.in, amazon.com.mx, amazon.com.br.

Example:

amazon.com

marketplaceId

optional

Amazon marketplace id. Domain amazon.com is used by default if domain and marketplaceId are not provided. If both domain and marketplaceId are chosen, domain has bigger priority. See all options here.

Example:

ATVPDKIKX0DER

Responses

🟢200OK

application/json

Successful response

Body

payload

object

optional

ShipmentData

array[object (OldShipment) {10}]

optional

NextToken

string

optional

Pagination token for next page of results

Example

{
    "payload": {
        "ShipmentData": [
            {
                "ShipmentId": "FBA3MXN6HN",
                "ShipmentName": "FBA (5/25/16 9:36 AM) - 1",
                "ShipFromAddress": {
                    "Name": "string",
                    "AddressLine1": "string",
                    "AddressLine2": null,
                    "DistrictOrCounty": null,
                    "City": "string",
                    "StateOrProvinceCode": "string",
                    "CountryCode": "string",
                    "PostalCode": "string"
                },
                "DestinationFulfillmentCenterId": "CHA1",
                "ShipmentStatus": "WORKING",
                "LabelPrepType": "NO_LABEL",
                "AreCasesRequired": true,
                "ConfirmedNeedByDate": "2025-05-26",
                "BoxContentsSource": "NONE",
                "EstimatedBoxContentsFee": {
                    "TotalUnits": 0,
                    "FeePerUnit": {
                        "CurrencyCode": "USD",
                        "Value": 0
                    },
                    "TotalFee": {
                        "CurrencyCode": "USD",
                        "Value": 0
                    }
                }
            }
        ],
        "NextToken": "string"
    }
}

🟠402402

🟠403Forbidden

🟠422Parameter Error

🟠429429

🔴500Server Error

Request

Request samples

Responses