getShipment - Amazon SP API

Rate (requests per second)	Burst
5	15

Rate (requests per second)

Burst

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Success.

Headers

x-amzn-RateLimit-Limit

string

optional

Your rate limit (requests per second) for this operation.

x-amzn-RequestId

string

optional

Unique request reference id.

Body

Response schema.

payload

object (Shipment)

optional

Contains information pertaining to a shipment in an inbound plan.

Example:

{"destination":{"destinationType":"AMAZON_OPTIMIZED"},"freightInformation":{"declaredValue":{"amount":5.5,"code":"CAD"},"freightClass":"FC_50"},"inboundPlanId":"wf1234abcd-1234-abcd-5678-1234abcd5678","placementOptionId":"pl1234abcd-1234-abcd-5678-1234abcd5678","selectedDeliveryWindow":{"availabilityType":"AVAILABLE","deliveryWindowOptionId":"dw1234abcd-1234-abcd-5678-1234abcd5678","editableUntil":"2024-01-05T20:00:00.000Z","endDate":"2024-01-05T20:00:00.000Z","startDate":"2024-01-05T14:00:00.000Z"},"shipmentConfirmationId":"shipmentConfirmationId","shipmentId":"sh1234abcd-1234-abcd-5678-1234abcd5678","source":{"sourceType":"SELLER_FACILITY"}}

amazonReferenceId

string

optional

A unique identifier created by Amazon that identifies this Amazon-partnered, Less Than Truckload/Full Truckload (LTL/FTL) shipment.

>= 1 characters<= 1024 characters

contactInformation

object (ContactInformation)

optional

The seller's contact information.

Example:

{"email":"email@email.com","name":"name","phoneNumber":"1234567890"}

dates

object (Dates)

optional

Specifies the date that the seller expects their shipment will be shipped.

Example:

{"readyToShipWindow":{"end":"2024-01-06T14:48:00.000Z","start":"2024-01-05T14:48:00.000Z"}}

destination

object (ShipmentDestination)

required

The Amazon fulfillment center address and warehouse ID.

freightInformation

object (FreightInformation)

optional

Freight information describes the skus being transported. Freight carrier options and quotes will only be returned if the freight information is provided.

Example:

{"declaredValue":{"amount":5.5,"code":"CAD"},"freightClass":"FC_50"}

name

string

optional

The name of the shipment.

placementOptionId

string

required

The identifier of a placement option. A placement option represents the shipment splits and destinations of SKUs.

>= 38 characters<= 38 characters

Match pattern:

^[a-zA-Z0-9-]*$

selectedDeliveryWindow

object (SelectedDeliveryWindow)

optional

Selected delivery window attributes.

Example:

{"availabilityType":"AVAILABLE","deliveryWindowOptionId":"dw1234abcd-1234-abcd-5678-1234abcd5678","editableUntil":"2024-01-05T20:00:00.000Z","endDate":"2024-01-05T20:00:00.000Z","startDate":"2024-01-05T14:00:00.000Z"}

selectedTransportationOptionId

string

optional

Identifier of a transportation option. A transportation option represent one option for how to send a shipment.

>= 38 characters<= 38 characters

Match pattern:

^[a-zA-Z0-9-]*$

selfShipAppointmentDetails

array[object (SelfShipAppointmentDetails) {3}]

optional

List of self ship appointment details.

shipmentConfirmationId

string

optional

The confirmed shipment ID which shows up on labels (for example, FBA1234ABCD).

>= 1 characters<= 1024 characters

shipmentId

string

required

Identifier of a shipment. A shipment contains the boxes and units being inbounded.

>= 38 characters<= 38 characters

Match pattern:

^[a-zA-Z0-9-]*$

source

object (ShipmentSource)

required

Specifies the 'ship from' address for the shipment.

status

string

optional

The status of a shipment. The state of the shipment will typically start as UNCONFIRMED, then transition to WORKING after a placement option has been confirmed, and then to READY_TO_SHIP once labels are generated.

Possible values: ABANDONED, CANCELLED, CHECKED_IN, CLOSED, DELETED, DELIVERED, IN_TRANSIT, MIXED, READY_TO_SHIP, RECEIVING, SHIPPED, UNCONFIRMED, WORKING

>= 1 characters<= 1024 characters

trackingDetails

object (TrackingDetails)

optional

Representation of tracking metadata.

errors

array[object (Error) {3}]

optional

A list of error responses that are returned when a request is unsuccessful.

code

string

required

An error code that identifies the type of error that occurred.

message

string

required

A message that describes the error condition.

details

string

optional

Additional details that can help the caller understand or fix the issue.

Example

{
    "shipmentId": "89108749065090",
    "clientReferenceId": "911-7267646-6348616",
    "shipFrom": {},
    "shipTo": {},
    "acceptedRate": {
        "billedWeight": {
            "value": 4,
            "unit": "kg"
        },
        "totalCharge": {
            "value": 3.5,
            "unit": "GBP"
        },
        "serviceType": "Amazon Shipping Standard",
        "promise": {
            "deliveryWindow": {
                "start": "2018-08-25T20:22:30.737Z",
                "end": "2018-08-26T20:22:30.737Z"
            },
            "receiveWindow": {
                "start": "2018-08-23T09:22:30.737Z",
                "end": "2018-08-23T11:22:30.737Z"
            }
        }
    },
    "shipper": {
        "accountId": "2755049166"
    },
    "containers": [
        {
            "containerReferenceId": "CRI123456789",
            "items": [
                {
                    "title": "String",
                    "unitWeight": {
                        "value": 0.08164656,
                        "unit": "kg"
                    },
                    "quantity": 2,
                    "unitPrice": {
                        "value": 14.99,
                        "unit": "GBP"
                    }
                }
            ],
            "dimensions": {
                "height": 12,
                "length": 36,
                "width": 31,
                "unit": "CM"
            },
            "containerType": "PACKAGE",
            "weight": {
                "unit": "kg",
                "value": 4
            },
            "value": {
                "value": 29.98,
                "unit": "GBP"
            }
        }
    ]
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠429429

🔴500Server Error

🔴503Service Unavailable