listHandoverSlots

post https://sellingpartnerapi-na.amazon.com/easyShip/2022-03-23/timeSlot

Returns time slots available for Easy Ship orders to be scheduled based on the package weight and dimensions that the seller specifies.

This operation is available for scheduled and unscheduled orders based on marketplace support. See Get Time Slots in the Marketplace Support Table.

This operation can return time slots that have either pickup or drop-off handover methods - see Supported Handover Methods in the Marketplace Support Table.

Usage Plan:

Rate (requests per second)	Burst
1	5

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see Usage Plans and Rate Limits in the Selling Partner API.

Responses

Response body

object

amazonOrderId

string

required

An Amazon-defined order identifier. Identifies the order that the seller wants to deliver using Amazon Easy Ship.

timeSlots

array of objects

required

length between 1 and 500

A list of time slots.

timeSlots*

object

slotId

string

required

length between 1 and 255

A string of up to 255 characters.

startTime

date-time

A datetime value in ISO 8601 format.

endTime

date-time

A datetime value in ISO 8601 format.

handoverMethod

string

Identifies the method by which a seller will hand a package over to Amazon Logistics.

Pickup Dropoff

Show Details

Pickup	An Amazon Logistics carrier will pickup the package(s) from the seller's pickup address.
Dropoff	Seller will need to drop off the package(s) to a designated location.

Headers

object

x-amzn-RateLimit-Limit

string

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

x-amzn-RequestId

string

Unique request reference identifier.

Language


xxxxxxxxxx
1
curl --request POST \
2
     --url https://sellingpartnerapi-na.amazon.com/easyShip/2022-03-23/timeSlot \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json'


xxxxxxxxxx
11
 
1
{
2
  "amazonOrderId": "string",
3
  "timeSlots": [
4
    {
5
      "slotId": "string",
6
      "startTime": "2025-04-01T16:53:31.857Z",
7
      "endTime": "2025-04-01T16:53:31.857Z",
8
      "handoverMethod": "Pickup"
9
    }
10
  ]
11
}

200Success.

400Request has missing or invalid parameters and cannot be parsed.

401The request's Authorization header is not formatted correctly or does not contain a valid token.

403Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.

404The resource specified does not exist.

413The request size exceeded the maximum accepted size.

415The request payload is in an unsupported format.

429The frequency of requests was greater than allowed.

500An unexpected condition occurred that prevented the server from fulfilling the request.

503Temporary overloading or maintenance of the server.