Response Format
How SP-API returns response headers and messages.
In response to an HTTP request, the Selling Partner API returns response headers and a JSON response message.
The following table lists the response headers you may receive. The actual headers you receive will depend on the specific API section and operation.
Response headers
Name | Description | Example |
---|---|---|
Connection | Default value keep-alive for a persistent connection with the client. | Connection: keep-alive |
Content-Length | Standard HTTP response header. | Content-Length: 624 |
Content-Type | Standard HTTP response header. | Content-Type: application/json |
Date | Standard HTTP response header. | Date: Fri, 17 Feb 2023 20:13:55 GMT |
x-amz-apigw-id | Extended request ID created by APIGateway. This header is optional and may not be returned. | x-amz-apigw-id: Ac1E1EycvHcFyNw= |
x-amzn-ErrorType | APIGateway populates this error with the errorType if the response status code is 4xx or 5xx. This header is optional and may not be returned. | x-amzn-ErrorType: AccessDeniedException |
x-amzn-RateLimit-Limit | Returns the rate limit applied to the request. This header is returned on a best-effort basis and only for specific HTTP responses. Refer to Usage Plans and Rate Limits in the SP-API for more information. | x-amzn-RateLimit-Limit: 2.0 |
x-amzn-RequestId | Request identifier. Provide this if you contact us for support. | x-amzn-RequestId: 6875f61f-6aa1-11e8-98c6-9bExample |
X-Amzn-Trace-Id | A trace identifier generated by APIGateway. This header is optional and may not be returned. | X-Amzn-Trace-Id: Root=1-63ee9bb8-52ea8e6d108209842abc2a4d |
Success response
If your request is successful, the Selling Partner API returns the data requested. Here is an example of a successful response:
HTTP/1.1 200 OK
Content-Length: 368
Content-Type: application/json
Date: Thu, 01 Jun 2020 22:23:31 GMT
x-amzn-RequestId: 6875f61f-6aa1-11e8-98c6-9bExample
{
"payload": {
"ConfirmedNeedByDate": "2020-04-23",
"ConfirmedFulfillableDate": "2020-04-23"
}
}
Error response
If your request is unsuccessful, the Selling Partner API returns an error response. Here are the elements of the response message in an error response:
Response message
Element | Description | Required |
---|---|---|
code | HTTP status code. | Yes |
message | Explanation of the error condition. | Yes |
details | Link to additional information. | No |
Here is an example of an error response:
HTTP/1.1 400 Bad Request
Content-Length: 117
Content-Type: application/json
Date: Fri, 01 Jun 2020 21:48:02 GMT
x-amzn-ErrorType: ValidationException
x-amzn-RequestId: a8c8d99a-6ab5-11e8-b0f8-19363980175b
{
"errors": [
{
"message": "Access to requested resource is denied.",
"code": "Unauthorized",
"details": "Access token is missing in the request header."
}
]
}
Updated 4 months ago