SP-API FBA Shipments

Get old 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.

get/api/v1/sp-api/fba/inbound/v0/shipments

Request

  • Base URL: https://app.sellerassistant.app (the document declares no server; this is the origin it was published from)
  • URL: https://app.sellerassistant.app/api/v1/sp-api/fba/inbound/v0/shipments
  • Auth: one of:
    • API key in query parameter api_key
    • API key in header X-Api-Key

Query parameters

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.

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.

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.

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.

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.

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

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.

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.

Response

Successful response

Example response

{
  "payload": {
    "ShipmentData": [
      {
        "ShipmentId": "FBA3MXN6HN",
        "ShipmentName": "FBA (5/25/16 9:36 AM) - 1",
        "DestinationFulfillmentCenterId": "CHA1",
        "ShipmentStatus": "CLOSED",
        "LabelPrepType": "SELLER_LABEL",
        "AreCasesRequired": true,
        "ConfirmedNeedByDate": "2025-05-26",
        "BoxContentsSource": "INTERACTIVE",
        "EstimatedBoxContentsFee": {
          "FeePerUnit": {
            "CurrencyCode": "USD"
          },
          "TotalFee": {
            "CurrencyCode": "USD"
          }
        }
      }
    ]
  }
}

Changes

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