Get old shipments

GET

https://app.sellerassistant.app/api/v1/sp-api/fba/inbound/v0/shipments

Proxy to https://developer-docs.amazon.com/sp-api/reference/getshipments. The limit is 60 requests per minute. Amazon seller account integration is required to make this request. You can do it here.

Request

Authorization

API Key

Add parameter in query

api_key

Example:

api_key: ********************

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

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.

Possible values:

WORKING: The shipment was created by the seller, but has not yet shipped.

READY_TO_SHIP: The seller has printed box labels (for Small parcel shipments) or pallet labels (for Less Than Truckload shipments).

SHIPPED: The shipment was picked up by the carrier.

RECEIVING: The shipment has arrived at the fulfillment center, but not all items have been marked as received.

CANCELLED: The shipment was cancelled by the seller after the shipment was sent to the fulfillment center.

DELETED: The shipment was cancelled by the seller before the shipment was sent to the fulfillment center.

CLOSED: The shipment has arrived at the fulfillment center and all items have been marked as received.

ERROR: There was an error with the shipment and it was not processed by Amazon.

IN_TRANSIT: The carrier has notified the fulfillment center that it is aware of the shipment.

DELIVERED: The shipment was delivered by the carrier to the fulfillment center.

CHECKED_IN: The shipment was checked-in at the receiving dock of the fulfillment center.

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

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://app.sellerassistant.app/api/v1/sp-api/fba/inbound/v0/shipments?queryType=SHIPMENT&api_key'

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

Modified at 2025-07-24 13:23:29

Get shipment fees

Get old shipment items