Amazon SP API

getRates

Pending

POST

/shipping/v1/rates

shipping

Last modified:2024-11-28 09:36:30

Maintainer:Not configured

Get service rates.

Usage Plan:

Rate (requests per second)	Burst
5	15

For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.

Request

Body Params application/json

The payload schema for the getRates operation.

shipTo

object (Address)

required

Shipping address that represents the origin or destination location.

Example:

{"addressLine1":"address_1","addressLine2":"address_2","addressLine3":"address_3","city":"Seattle","countryCode":"US","county":"Washington","district":"District1","name":"address_name","phoneNumber":"+14155552671","postalCode":"123456","stateOrRegion":"Washington"}

addressLine1

string

required

First line of the address text.

addressLine2

string

optional

Optional second line of the address text.

addressLine3

string

optional

Optional third line of the address text.

city

string

optional

Optional city where this address is located.

countryCode

string

required

Two-digit, ISO 3166-1 alpha-2 formatted country code where this address is located.

county

string

optional

Optional county where this address is located.

Example:

Washington

district

string

optional

Optional district where this address is located.

name

string

required

Name of the person, business, or institution at this address.

phoneNumber

string

optional

Optional E.164-formatted phone number for an available contact at this address.

Example:

+14155552671

postalCode

string

optional

Optional postal code where this address is located.

stateOrRegion

string

required

State or region where this address is located. Note that this is contextual to the specified country code.

shipFrom

object (Address)

required

Shipping address that represents the origin or destination location.

Example:

serviceTypes

array[string]

required

A list of service types that can be used to send the shipment.

Allowed values:

Amazon Shipping GroundAmazon Shipping StandardAmazon Shipping Premium

shipDate

string <date-time>

optional

The start date and time. This defaults to the current date and time.

containerSpecifications

array[object (ContainerSpecification) {2}]

required

A list of container specifications.

dimensions

object (Dimensions)

required

Dimensions of an Amazon catalog item or item in its packaging.

weight

object (Weight)

required

The weight of the scheduled package

Example

{
    "shipTo": {
        "addressLine1": "address_1",
        "addressLine2": "address_2",
        "addressLine3": "address_3",
        "city": "Seattle",
        "countryCode": "US",
        "county": "Washington",
        "district": "District1",
        "name": "address_name",
        "phoneNumber": "+14155552671",
        "postalCode": "123456",
        "stateOrRegion": "Washington"
    },
    "shipFrom": {
        "addressLine1": "address_1",
        "addressLine2": "address_2",
        "addressLine3": "address_3",
        "city": "Seattle",
        "countryCode": "US",
        "county": "Washington",
        "district": "District1",
        "name": "address_name",
        "phoneNumber": "+14155552671",
        "postalCode": "123456",
        "stateOrRegion": "Washington"
    },
    "serviceTypes": [
        "Amazon Shipping Ground"
    ],
    "shipDate": "2019-08-24T14:15:22Z",
    "containerSpecifications": [
        {
            "dimensions": {
                "height": {
                    "unit": "string",
                    "value": 0
                },
                "length": {
                    "unit": "string",
                    "value": 0
                },
                "weight": {
                    "unit": "string",
                    "value": 0
                },
                "width": {
                    "unit": "string",
                    "value": 0
                }
            },
            "weight": {
                "value": 11,
                "unit": "Grams"
            }
        }
    ]
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sandbox.sellingpartnerapi-na.amazon.com/shipping/v1/rates' \
--header 'Content-Type: application/json' \
--data-raw '{
    "shipTo": {
        "addressLine1": "address_1",
        "addressLine2": "address_2",
        "addressLine3": "address_3",
        "city": "Seattle",
        "countryCode": "US",
        "county": "Washington",
        "district": "District1",
        "name": "address_name",
        "phoneNumber": "+14155552671",
        "postalCode": "123456",
        "stateOrRegion": "Washington"
    },
    "shipFrom": {
        "addressLine1": "address_1",
        "addressLine2": "address_2",
        "addressLine3": "address_3",
        "city": "Seattle",
        "countryCode": "US",
        "county": "Washington",
        "district": "District1",
        "name": "address_name",
        "phoneNumber": "+14155552671",
        "postalCode": "123456",
        "stateOrRegion": "Washington"
    },
    "serviceTypes": [
        "Amazon Shipping Ground"
    ],
    "shipDate": "2019-08-24T14:15:22Z",
    "containerSpecifications": [
        {
            "dimensions": {
                "height": {
                    "unit": "string",
                    "value": 0
                },
                "length": {
                    "unit": "string",
                    "value": 0
                },
                "weight": {
                    "unit": "string",
                    "value": 0
                },
                "width": {
                    "unit": "string",
                    "value": 0
                }
            },
            "weight": {
                "value": 11,
                "unit": "Grams"
            }
        }
    ]
}'

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

The response schema for the getRates operation.

payload

object (GetRatesResult)

optional

The payload schema for the getRates operation.

serviceRates

array[object (ServiceRate) {4}]

required

A list of service rates.

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

{
    "serviceRates": [
        {
            "billableWeight": {
                "value": 4,
                "unit": "kg"
            },
            "totalCharge": {
                "value": 3.25,
                "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"
                }
            }
        }
    ]
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠429429

🔴500Server Error

🔴503Service Unavailable

cancelShipment

getAdditionalInputs