Shipping API v2 Model
Swagger model for the Shipping API v2.
{
"swagger": "2.0",
"info": {
"description": "The Amazon Shipping API is designed to support outbound shipping use cases both for orders originating on Amazon-owned marketplaces as well as external channels/marketplaces. With these APIs, you can request shipping rates, create shipments, cancel shipments, and track shipments.",
"version": "v2",
"title": "Amazon Shipping API",
"contact": {
"name": "Amazon Shipping API Support",
"email": "[email protected]"
},
"license": {
"name": "Amazon Software License",
"url": "https://aws.amazon.com/asl/"
}
},
"host": "sellingpartnerapi-eu.amazon.com",
"schemes": [
"https"
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"paths": {
"/shipping/v2/shipments/rates": {
"post": {
"tags": [
"shipping"
],
"description": "Returns the available shipping service offerings.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 80 | 100 |\n\nThe `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 then those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).",
"operationId": "getRates",
"parameters": [
{
"in": "body",
"name": "body",
"required": true,
"schema": {
"$ref": "#/definitions/GetRatesRequest"
}
},
{
"name": "x-amzn-shipping-business-id",
"in": "header",
"description": "Amazon shipping business to assume for this request. The default is AmazonShipping_UK.",
"required": false,
"type": "string",
"enum": [
"AmazonShipping_US",
"AmazonShipping_IN",
"AmazonShipping_UK",
"AmazonShipping_UAE",
"AmazonShipping_SA",
"AmazonShipping_EG",
"AmazonShipping_IT",
"AmazonShipping_ES",
"AmazonShipping_FR",
"AmazonShipping_JP"
],
"x-docgen-enum-table-extension": [
{
"value": "AmazonShipping_US",
"description": "The United States Amazon shipping business."
},
{
"value": "AmazonShipping_IN",
"description": "The India Amazon shipping business."
},
{
"value": "AmazonShipping_UK",
"description": "The United Kingdom Amazon shipping business."
},
{
"value": "AmazonShipping_UAE",
"description": "The United Arab Emirates Amazon shipping business."
},
{
"value": "AmazonShipping_SA",
"description": "The Saudi Arabia Amazon shipping business."
},
{
"value": "AmazonShipping_EG",
"description": "The Egypt Amazon shipping business."
},
{
"value": "AmazonShipping_IT",
"description": "The Italy Amazon shipping business."
},
{
"value": "AmazonShipping_ES",
"description": "The Spain Amazon shipping business."
},
{
"value": "AmazonShipping_FR",
"description": "The France Amazon shipping business."
},
{
"value": "AmazonShipping_JP",
"description": "The Japan Amazon shipping business."
}
]
}
],
"responses": {
"200": {
"description": "Success.",
"schema": {
"$ref": "#/definitions/GetRatesResponse"
},
"examples": {
"application/json": {
"requestToken": "6DCCEDD3FF961C15FEB94F342D41C",
"rates": [
{
"rateId": "F4B68849F969E239FF9FCA9C12E35",
"carrierId": "FOOSHIPGRD",
"carrierName": "FOO SHIP GRD",
"billedWeight": {
"value": 5,
"unit": "GRAMS"
},
"totalCharge": {
"value": 7,
"unit": "USD"
},
"serviceId": "FOORSID",
"serviceName": "FOO RS ID",
"promise": {
"deliveryWindow": {
"start": "2018-08-24T08:22:30.737Z",
"end": "2018-08-24T20:22:30.737Z"
},
"pickupWindow": {
"start": "2018-08-23T08:22:30.737Z",
"end": "2018-08-23T20:22:30.737Z"
}
},
"supportedDocumentSpecifications": [
{
"format": "PNG",
"size": {
"length": 6,
"width": 4,
"unit": "INCH"
},
"printOptions": [
{
"supportedDPIs": [
300,
203
],
"supportedPageLayouts": [
"LEFT",
"RIGHT"
],
"supportedFileJoiningOptions": [
true,
false
],
"supportedDocumentDetails": [
{
"name": "LABEL",
"isMandatory": true
}
]
}
]
},
{
"format": "ZPL",
"size": {
"length": 6,
"width": 4,
"unit": "INCH"
},
"printOptions": [
{
"supportedDPIs": [
300,
203
],
"supportedPageLayouts": [
"LEFT",
"RIGHT"
],
"supportedFileJoiningOptions": [
true,
false
],
"supportedDocumentDetails": [
{
"name": "LABEL",
"isMandatory": true
}
]
}
]
}
],
"availableValueAddedServiceGroups": [
{
"groupId": "SIG_VERIFICATION",
"groupDescription": "Signature Verification",
"isRequired": true,
"valueAddedServices": [
{
"id": "CUST_SIG_VERIFICATION",
"name": "Customer Signature Verification",
"cost": {
"unit": "USD",
"value": 2
}
}
]
}
],
"requiresAdditionalInputs": false,
"rateItemList":[
{
"rateItemCharge":{
"unit":"INR",
"value":"2.00000"
},
"rateItemID":"BASE_RATE",
"rateItemNameLocalization":"Base Rate",
"rateItemType":"MANDATORY"
},
{
"rateItemCharge":{
"unit":"INR",
"value":"1.20000"
},
"rateItemID":"DELIVERY_CONFIRMATION",
"rateItemNameLocalization":"Delivery Confirmation",
"rateItemType":"INCLUDED"
},
{
"rateItemCharge":{
"unit":"INR",
"value":"2.00"
},
"rateItemID":"VAT",
"rateItemNameLocalization":"VAT",
"rateItemType":"MANDATORY"
}
],
"paymentType": "PAY_THROUGH_AMAZON"
}
],
"ineligibleRates": [
{
"carrierId": "FOOSTDGRD",
"serviceId": "FOO8420430",
"carrierName": "FOOSTDGRD",
"serviceName": "FOO8420430",
"ineligibilityReasons": [
{
"code": "NO_COVERAGE",
"message": "Required shipping network coverage doesn't exist for the offering"
}
]
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InvalidRequest",
"message": "Request is missing or has invalid parameters",
"details": "ChannelDetails object cannot be null"
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"401": {
"description": "The request's Authorization header is not formatted correctly or does not contain a valid token.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "Unauthorized",
"message": "You don't have access to the requested response or the credentials are invalid."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "Unauthorized",
"message": "You don't have access to the requested response or the credentials are invalid."
}
]
}
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"404": {
"description": "The resource specified does not exist.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "NotFound",
"message": "The requested resource is invalid or doesn't exist"
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InvalidRequest",
"message": "The request payload size is greater than maximum accepted size."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InvalidRequest",
"message": "The request payload format is not supported."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "TooManyRequests",
"message": "The total number of requests exceeded your allowed limit."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InternalError",
"message": "Something went wrong while processing the request."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "ServiceUnavailable",
"message": "Service temporarily unavailable or down for maintenance. Please try again after sometime."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
}
},
"x-amzn-api-sandbox": {
"dynamic": {}
}
},
"parameters": []
},
"/shipping/v2/shipments": {
"post": {
"tags": [
"shipping"
],
"description": "Purchases a shipping service and returns purchase related details and documents.\n\nNote: You must complete the purchase within 10 minutes of rate creation by the shipping service provider. If you make the request after the 10 minutes have expired, you will receive an error response with the error code equal to \"TOKEN_EXPIRED\". If you receive this error response, you must get the rates for the shipment again.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 80 | 100 |\n\nThe `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 then those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).",
"operationId": "purchaseShipment",
"parameters": [
{
"in": "body",
"name": "body",
"required": true,
"schema": {
"$ref": "#/definitions/PurchaseShipmentRequest"
}
},
{
"name": "x-amzn-IdempotencyKey",
"description": "A unique value which the server uses to recognize subsequent retries of the same request.",
"in": "header",
"required": false,
"type": "string"
},
{
"name": "x-amzn-shipping-business-id",
"in": "header",
"description": "Amazon shipping business to assume for this request. The default is AmazonShipping_UK.",
"required": false,
"type": "string",
"enum": [
"AmazonShipping_US",
"AmazonShipping_IN",
"AmazonShipping_UK",
"AmazonShipping_UAE",
"AmazonShipping_SA",
"AmazonShipping_EG",
"AmazonShipping_IT",
"AmazonShipping_ES",
"AmazonShipping_FR",
"AmazonShipping_JP"
],
"x-docgen-enum-table-extension": [
{
"value": "AmazonShipping_US",
"description": "The United States Amazon shipping business."
},
{
"value": "AmazonShipping_IN",
"description": "The India Amazon shipping business."
},
{
"value": "AmazonShipping_UK",
"description": "The United Kingdom Amazon shipping business."
},
{
"value": "AmazonShipping_UAE",
"description": "The United Arab Emirates Amazon shipping business."
},
{
"value": "AmazonShipping_SA",
"description": "The Saudi Arabia Amazon shipping business."
},
{
"value": "AmazonShipping_EG",
"description": "The Egypt Amazon shipping business."
},
{
"value": "AmazonShipping_IT",
"description": "The Italy Amazon shipping business."
},
{
"value": "AmazonShipping_ES",
"description": "The Spain Amazon shipping business."
},
{
"value": "AmazonShipping_FR",
"description": "The France Amazon shipping business."
},
{
"value": "AmazonShipping_JP",
"description": "The Japan Amazon shipping business."
}
]
}
],
"responses": {
"200": {
"description": "Success.",
"schema": {
"$ref": "#/definitions/PurchaseShipmentResponse"
},
"examples": {
"application/json": {
"shipmentId": "87852211788104",
"packageDocumentDetails": [
{
"packageClientReferenceId": "abcd",
"packageDocuments": [
{
"type": "LABEL",
"format": "PNG",
"contents": "sdioadaiosfhdodsaiufhouafhoudfhdouahfac=="
}
],
"trackingId": 1578648261977
}
],
"promise": {
"pickupWindow": {
"start": "2019-12-11T07:09:05.513Z",
"end": "2019-12-11T09:09:05.513Z"
},
"deliveryWindow": {
"start": "2019-12-13T07:09:05.513Z",
"end": "2019-12-13T09:09:05.513Z"
}
}
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InvalidRequest",
"message": "Request is missing or has invalid parameters",
"details": "RateId cannot be null"
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"401": {
"description": "The request's Authorization header is not formatted correctly or does not contain a valid token.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "Unauthorized",
"message": "You don't have access to the requested response or the credentials are invalid."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "Unauthorized",
"message": "You don't have access to the requested response or the credentials are invalid."
}
]
}
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"404": {
"description": "The resource specified does not exist.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "NotFound",
"message": "The requested resource is invalid or doesn't exist"
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InvalidRequest",
"message": "The request payload size is greater than maximum accepted size."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InvalidRequest",
"message": "The request payload format is not supported."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "TooManyRequests",
"message": "The total number of requests exceeded your allowed limit."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InternalError",
"message": "Something went wrong while processing the request."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "ServiceUnavailable",
"message": "Service temporarily unavailable or down for maintenance. Please try again after sometime."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
}
},
"x-amzn-api-sandbox": {
"dynamic": {}
}
},
"parameters": []
},
"/shipping/v2/oneClickShipment": {
"post": {
"tags": [
"shipping"
],
"description": "Purchases a shipping service identifier and returns purchase-related details and documents.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 80 | 100 |\n\nThe `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 then those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).",
"operationId": "oneClickShipment",
"parameters": [
{
"in": "body",
"name": "body",
"required": true,
"schema": {
"$ref": "#/definitions/OneClickShipmentRequest"
}
},
{
"name": "x-amzn-shipping-business-id",
"in": "header",
"description": "Amazon shipping business to assume for this request. The default is AmazonShipping_UK.",
"required": false,
"type": "string",
"enum": [
"AmazonShipping_US",
"AmazonShipping_IN",
"AmazonShipping_UK",
"AmazonShipping_UAE",
"AmazonShipping_SA",
"AmazonShipping_EG",
"AmazonShipping_IT",
"AmazonShipping_ES",
"AmazonShipping_FR",
"AmazonShipping_JP"
],
"x-docgen-enum-table-extension": [
{
"value": "AmazonShipping_US",
"description": "The United States Amazon shipping business."
},
{
"value": "AmazonShipping_IN",
"description": "The India Amazon shipping business."
},
{
"value": "AmazonShipping_UK",
"description": "The United Kingdom Amazon shipping business."
},
{
"value": "AmazonShipping_UAE",
"description": "The United Arab Emirates Amazon shipping business."
},
{
"value": "AmazonShipping_SA",
"description": "The Saudi Arabia Amazon shipping business."
},
{
"value": "AmazonShipping_EG",
"description": "The Egypt Amazon shipping business."
},
{
"value": "AmazonShipping_IT",
"description": "The Italy Amazon shipping business."
},
{
"value": "AmazonShipping_ES",
"description": "The Spain Amazon shipping business."
},
{
"value": "AmazonShipping_FR",
"description": "The France Amazon shipping business."
},
{
"value": "AmazonShipping_JP",
"description": "The Japan Amazon shipping business."
}
]
}
],
"responses": {
"200": {
"description": "Success.",
"schema": {
"$ref": "#/definitions/OneClickShipmentResponse"
},
"examples": {
"application/json": {
"shipmentId": "87852211788104",
"packageDocumentDetails": [
{
"packageClientReferenceId": "#abcd",
"packageDocuments": [
{
"type": "LABEL",
"format": "PNG",
"contents": "sdioadaiosfhdodsaiufhouafhoudfhdouahfac=="
}
],
"trackingId": 1578648261977
}
],
"promise": {
"pickupWindow": {
"start": "2019-12-11T07:09:05.513Z",
"end": "2019-12-11T09:09:05.513Z"
},
"deliveryWindow": {
"start": "2019-12-13T07:09:05.513Z",
"end": "2019-12-13T09:09:05.513Z"
}
},
"carrier" : {
"id": "AMZN_UK",
"name": "Amazon Shipping"
},
"service" : {
"id": "SWA-UK-PREM",
"name": "Amazon Shipping One Day"
},
"totalCharge": {
"unit": "GBP",
"value": 4.76
}
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InvalidRequest",
"message": "Request is missing or has invalid parameters",
"details": "ServiceId cannot be null"
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"401": {
"description": "The request's Authorization header is not formatted correctly or does not contain a valid token.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "Unauthorized",
"message": "You don't have access to the requested response or the credentials are invalid."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "Unauthorized",
"message": "You don't have access to the requested response or the credentials are invalid."
}
]
}
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"404": {
"description": "The resource specified does not exist.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "NotFound",
"message": "The requested resource is invalid or doesn't exist"
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InvalidRequest",
"message": "The request payload size is greater than maximum accepted size."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InvalidRequest",
"message": "The request payload format is not supported."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "TooManyRequests",
"message": "The total number of requests exceeded your allowed limit."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InternalError",
"message": "Something went wrong while processing the request."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "ServiceUnavailable",
"message": "Service temporarily unavailable or down for maintenance. Please try again after sometime."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
}
},
"x-amzn-api-sandbox": {
"dynamic": {}
}
},
"parameters": []
},
"/shipping/v2/tracking": {
"get": {
"tags": [
"shipping"
],
"description": "Returns tracking information for a purchased shipment.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 80 | 100 |\n\nThe `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 then those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).",
"operationId": "getTracking",
"parameters": [
{
"name": "trackingId",
"in": "query",
"description": "A carrier-generated tracking identifier originally returned by the purchaseShipment operation.",
"required": true,
"type": "string"
},
{
"name": "carrierId",
"in": "query",
"description": "A carrier identifier originally returned by the getRates operation for the selected rate.",
"required": true,
"type": "string"
},
{
"name": "x-amzn-shipping-business-id",
"in": "header",
"description": "Amazon shipping business to assume for this request. The default is AmazonShipping_UK.",
"required": false,
"type": "string",
"enum": [
"AmazonShipping_US",
"AmazonShipping_IN",
"AmazonShipping_UK",
"AmazonShipping_UAE",
"AmazonShipping_SA",
"AmazonShipping_EG",
"AmazonShipping_IT",
"AmazonShipping_ES",
"AmazonShipping_FR",
"AmazonShipping_JP"
],
"x-docgen-enum-table-extension": [
{
"value": "AmazonShipping_US",
"description": "The United States Amazon shipping business."
},
{
"value": "AmazonShipping_IN",
"description": "The India Amazon shipping business."
},
{
"value": "AmazonShipping_UK",
"description": "The United Kingdom Amazon shipping business."
},
{
"value": "AmazonShipping_UAE",
"description": "The United Arab Emirates Amazon shipping business."
},
{
"value": "AmazonShipping_SA",
"description": "The Saudi Arabia Amazon shipping business."
},
{
"value": "AmazonShipping_EG",
"description": "The Egypt Amazon shipping business."
},
{
"value": "AmazonShipping_IT",
"description": "The Italy Amazon shipping business."
},
{
"value": "AmazonShipping_ES",
"description": "The Spain Amazon shipping business."
},
{
"value": "AmazonShipping_FR",
"description": "The France Amazon shipping business."
},
{
"value": "AmazonShipping_JP",
"description": "The Japan Amazon shipping business."
}
]
}
],
"responses": {
"200": {
"description": "Success.",
"schema": {
"$ref": "#/definitions/GetTrackingResponse"
},
"examples": {
"application/json": {
"trackingId": "23AA47DE2B3B6",
"alternateLegTrackingId": "null",
"eventHistory": [
{
"eventCode": "Undeliverable",
"location": {
"postalCode": "EX33 2JL",
"countryCode": "GB"
},
"eventTime": "2024-02-11T07:09:05.513Z",
"shipmentType": "FORWARD"
},
{
"eventCode": "ReturnInitiated",
"location": {
"postalCode": "EX33 2JL",
"countryCode": "GB"
},
"eventTime": "2024-02-12T09:09:05.513Z",
"shipmentType": "RETURNS"
},
{
"eventCode": "Delivered",
"location": {
"postalCode": "EX33 2JL",
"countryCode": "GB"
},
"eventTime": "2024-02-13T04:09:05.513Z",
"shipmentType": "RETURNS"
}
],
"promisedDeliveryDate": "2024-02-12T13:09:05.513Z",
"summary": {
"status": "Delivered",
"trackingDetailCodes": {
"forward": ["Rejected", "Damaged"],
"returns": ["Signed"]
}
}
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InvalidRequest",
"message": "Request is missing or has invalid parameters",
"details": "CarrierId is missing in the request"
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"401": {
"description": "The request's Authorization header is not formatted correctly or does not contain a valid token.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "Unauthorized",
"message": "You don't have access to the requested response or the credentials are invalid."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "Unauthorized",
"message": "You don't have access to the requested response or the credentials are invalid."
}
]
}
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"404": {
"description": "The resource specified does not exist.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "NotFound",
"message": "The requested resource is invalid or doesn't exist"
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InvalidRequest",
"message": "The request payload size is greater than maximum accepted size."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InvalidRequest",
"message": "The request payload format is not supported."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "TooManyRequests",
"message": "The total number of requests exceeded your allowed limit."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InternalError",
"message": "Something went wrong while processing the request."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "ServiceUnavailable",
"message": "Service temporarily unavailable or down for maintenance. Please try again after sometime."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
}
},
"x-amzn-api-sandbox": {
"dynamic": {}
}
},
"parameters": []
},
"/shipping/v2/shipments/{shipmentId}/documents": {
"get": {
"tags": [
"shipping"
],
"description": "Returns the shipping documents associated with a package in a shipment.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 80 | 100 |\n\nThe `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 then those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).",
"operationId": "getShipmentDocuments",
"parameters": [
{
"name": "shipmentId",
"description":"The shipment identifier originally returned by the purchaseShipment operation.",
"in": "path",
"required": true,
"type": "string"
},
{
"name": "packageClientReferenceId",
"in": "query",
"description": "The package client reference identifier originally provided in the request body parameter for the getRates operation.",
"required": true,
"type": "string"
},
{
"name": "format",
"in": "query",
"description": "The file format of the document. Must be one of the supported formats returned by the getRates operation.",
"required": false,
"type": "string"
},
{
"name": "dpi",
"in": "query",
"description": "The resolution of the document (for example, 300 means 300 dots per inch). Must be one of the supported resolutions returned in the response to the getRates operation.",
"required": false,
"type": "number"
},
{
"name": "x-amzn-shipping-business-id",
"in": "header",
"description": "Amazon shipping business to assume for this request. The default is AmazonShipping_UK.",
"required": false,
"type": "string",
"enum": [
"AmazonShipping_US",
"AmazonShipping_IN",
"AmazonShipping_UK",
"AmazonShipping_UAE",
"AmazonShipping_SA",
"AmazonShipping_EG",
"AmazonShipping_IT",
"AmazonShipping_ES",
"AmazonShipping_FR",
"AmazonShipping_JP"
],
"x-docgen-enum-table-extension": [
{
"value": "AmazonShipping_US",
"description": "The United States Amazon shipping business."
},
{
"value": "AmazonShipping_IN",
"description": "The India Amazon shipping business."
},
{
"value": "AmazonShipping_UK",
"description": "The United Kingdom Amazon shipping business."
},
{
"value": "AmazonShipping_UAE",
"description": "The United Arab Emirates Amazon shipping business."
},
{
"value": "AmazonShipping_SA",
"description": "The Saudi Arabia Amazon shipping business."
},
{
"value": "AmazonShipping_EG",
"description": "The Egypt Amazon shipping business."
},
{
"value": "AmazonShipping_IT",
"description": "The Italy Amazon shipping business."
},
{
"value": "AmazonShipping_ES",
"description": "The Spain Amazon shipping business."
},
{
"value": "AmazonShipping_FR",
"description": "The France Amazon shipping business."
},
{
"value": "AmazonShipping_JP",
"description": "The Japan Amazon shipping business."
}
]
}
],
"responses": {
"200": {
"description": "Success.",
"schema": {
"$ref": "#/definitions/GetShipmentDocumentsResponse"
},
"examples": {
"application/json": {
"shipmentId": "445454-3232-3232",
"packageDocumentDetail": {
"packageClientReferenceId": "ASUSDI-45343854",
"trackingId": "T1234567",
"packageDocuments": [
{
"type": "LABEL",
"format": "PNG",
"contents": "sdioadaiosfhdodsaiufhouafhoudfhdouahfac=="
}
]
}
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InvalidRequest",
"message": "Request is missing or has invalid parameters",
"details": "shipmentId is missing in the request"
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"401": {
"description": "The request's Authorization header is not formatted correctly or does not contain a valid token.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "Unauthorized",
"message": "You don't have access to the requested response or the credentials are invalid."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "Unauthorized",
"message": "You don't have access to the requested response or the credentials are invalid."
}
]
}
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"404": {
"description": "The resource specified does not exist.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "NotFound",
"message": "The requested resource is invalid or doesn't exist"
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InvalidRequest",
"message": "The request payload size is greater than maximum accepted size."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InvalidRequest",
"message": "The request payload format is not supported."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "TooManyRequests",
"message": "The total number of requests exceeded your allowed limit."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InternalError",
"message": "Something went wrong while processing the request."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "ServiceUnavailable",
"message": "Service temporarily unavailable or down for maintenance. Please try again after sometime."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
}
},
"x-amzn-api-sandbox": {
"dynamic": {}
}
},
"parameters": []
},
"/shipping/v2/shipments/{shipmentId}/cancel": {
"put": {
"tags": [
"shipping"
],
"description": "Cancels a purchased shipment. Returns an empty object if the shipment is successfully cancelled.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 80 | 100 |\n\nThe `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 then those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).",
"operationId": "cancelShipment",
"parameters": [
{
"name": "shipmentId",
"description":"The shipment identifier originally returned by the purchaseShipment operation.",
"in": "path",
"required": true,
"type": "string"
},
{
"name": "x-amzn-shipping-business-id",
"in": "header",
"description": "Amazon shipping business to assume for this request. The default is AmazonShipping_UK.",
"required": false,
"type": "string",
"enum": [
"AmazonShipping_US",
"AmazonShipping_IN",
"AmazonShipping_UK",
"AmazonShipping_UAE",
"AmazonShipping_SA",
"AmazonShipping_EG",
"AmazonShipping_IT",
"AmazonShipping_ES",
"AmazonShipping_FR",
"AmazonShipping_JP"
],
"x-docgen-enum-table-extension": [
{
"value": "AmazonShipping_US",
"description": "The United States Amazon shipping business."
},
{
"value": "AmazonShipping_IN",
"description": "The India Amazon shipping business."
},
{
"value": "AmazonShipping_UK",
"description": "The United Kingdom Amazon shipping business."
},
{
"value": "AmazonShipping_UAE",
"description": "The United Arab Emirates Amazon shipping business."
},
{
"value": "AmazonShipping_SA",
"description": "The Saudi Arabia Amazon shipping business."
},
{
"value": "AmazonShipping_EG",
"description": "The Egypt Amazon shipping business."
},
{
"value": "AmazonShipping_IT",
"description": "The Italy Amazon shipping business."
},
{
"value": "AmazonShipping_ES",
"description": "The Spain Amazon shipping business."
},
{
"value": "AmazonShipping_FR",
"description": "The France Amazon shipping business."
},
{
"value": "AmazonShipping_JP",
"description": "The Japan Amazon shipping business."
}
]
}
],
"responses": {
"200": {
"description": "Success.",
"schema": {
"$ref": "#/definitions/CancelShipmentResponse"
},
"examples": {
"application/json": {}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InvalidRequest",
"message": "Request is missing or has invalid parameters",
"details": "ShipmentId cannot be null"
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"401": {
"description": "The request's Authorization header is not formatted correctly or does not contain a valid token.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "Unauthorized",
"message": "You don't have access to the requested response or the credentials are invalid."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "Unauthorized",
"message": "You don't have access to the requested response or the credentials are invalid."
}
]
}
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"404": {
"description": "The resource specified does not exist.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "NotFound",
"message": "The requested resource is invalid or doesn't exist"
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InvalidRequest",
"message": "The request payload size is greater than maximum accepted size."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InvalidRequest",
"message": "The request payload format is not supported."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "TooManyRequests",
"message": "The total number of requests exceeded your allowed limit."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InternalError",
"message": "Something went wrong while processing the request."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "ServiceUnavailable",
"message": "Service temporarily unavailable or down for maintenance. Please try again after sometime."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
}
},
"x-amzn-api-sandbox": {
"dynamic": {}
}
},
"parameters": []
},
"/shipping/v2/accessPoints": {
"get": {
"tags": [
"shipping"
],
"description": "Returns a list of access points in proximity of input postal code.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 80 | 100 |\n\nThe `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 then those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).",
"operationId": "getAccessPoints",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"parameters": [
{
"in": "query",
"name": "accessPointTypes",
"required": true,
"type": "array",
"items": {
"type": "string",
"enum": [
"HELIX",
"CAMPUS_LOCKER",
"OMNI_LOCKER",
"ODIN_LOCKER",
"DOBBY_LOCKER",
"CORE_LOCKER",
"3P",
"CAMPUS_ROOM"
]
},
"x-docgen-enum-table-extension": [
{
"value": "HELIX",
"description": "Counter, aka Helix, is an assisted access point where customers interact with a store associate to collect or return packages. Counter stores do not have Locker"
},
{
"value": "CAMPUS_LOCKER",
"description": "It denotes a physical Locker present at Locker+ stores"
},
{
"value": "OMNI_LOCKER",
"description": "Omni lockers are similar to core lockers installed at apartment buildings. Core and Omni will have common base hardware platform"
},
{
"value": "ODIN_LOCKER",
"description": "Odin lockers rely on Bluetooth connection as there is no screen or scanner on the locker. Drivers, customers, and even technicians can interact with the locker using an app (different depending on the user)."
},
{
"value": "DOBBY_LOCKER",
"description": "Dobby lockers are Odin lockers installed at apartment complexes and available only to residents."
},
{
"value": "CORE_LOCKER",
"description": "Core lockers are the traditional and initial style of lockers when Hub was launched. Core lockers have a screen, keypad and scanner. Customer either enter their pickup code using the Locker screen or scan pickup code barcode to pick up their package."
},
{
"value": "3P",
"description": "Networks that are owned end-to-end by commercial carriers (CC - e.g. DHL, UPS, DPD and Postal organizations), who operate both the transportation leg and the access point aspect. These networks offer a range of pickup points including: 3P Lockers, legacy Postal Offices, 3P Counters (e.g. Gas Stations and Retail Outlets - supermarkets, bookstores, news-stands etc)."
},
{
"value": "CAMPUS_ROOM",
"description": "Locker+, formerly known as Campus, are attended, physical stores, where the Locker is used dynamically by the staff to keep packages ready for customer pickup. Locker+ store can have multiple Lockers installed,"
}
],
"collectionFormat": "csv",
"x-example": "HELIX"
},
{
"in": "query",
"name": "countryCode",
"required": true,
"type": "string",
"collectionFormat": "csv",
"x-example": "US"
},
{
"in": "query",
"name": "postalCode",
"required": true,
"type": "string",
"collectionFormat": "csv",
"x-example": "EX332JL"
},
{
"name": "x-amzn-shipping-business-id",
"in": "header",
"description": "Amazon shipping business to assume for this request. The default is AmazonShipping_UK.",
"required": false,
"type": "string",
"enum": [
"AmazonShipping_US",
"AmazonShipping_IN",
"AmazonShipping_UK",
"AmazonShipping_UAE",
"AmazonShipping_SA",
"AmazonShipping_EG",
"AmazonShipping_IT",
"AmazonShipping_ES",
"AmazonShipping_FR",
"AmazonShipping_JP"
],
"x-docgen-enum-table-extension": [
{
"value": "AmazonShipping_US",
"description": "The United States Amazon shipping business."
},
{
"value": "AmazonShipping_IN",
"description": "The India Amazon shipping business."
},
{
"value": "AmazonShipping_UK",
"description": "The United Kingdom Amazon shipping business."
},
{
"value": "AmazonShipping_UAE",
"description": "The United Arab Emirates Amazon shipping business."
},
{
"value": "AmazonShipping_SA",
"description": "The Saudi Arabia Amazon shipping business."
},
{
"value": "AmazonShipping_EG",
"description": "The Egypt Amazon shipping business."
},
{
"value": "AmazonShipping_IT",
"description": "The Italy Amazon shipping business."
},
{
"value": "AmazonShipping_ES",
"description": "The Spain Amazon shipping business."
},
{
"value": "AmazonShipping_FR",
"description": "The France Amazon shipping business."
},
{
"value": "AmazonShipping_JP",
"description": "The Japan Amazon shipping business."
}
]
}
],
"responses": {
"200": {
"description": "Success.",
"schema": {
"$ref": "#/definitions/GetAccessPointsResponse"
},
"examples": {
"application/json": {
"HELIX": {
"accessPointId": "00046c4b-bb0a-4c03-831e-5633e142f16a",
"name": "Amazon Hub Counter - Co-op Braunton",
"timezone": "Europe/London",
"type": "HELIX",
"accessibilityAttributes": {
"distance": "21.200000762939453",
"driveTime": "0.0"
},
"address": {
"addressObject": {
"addressLine1": "Exeter Road",
"city": "Braunton",
"countryCode": "GB",
"zipOrPostalCode": "EX33 2JL"
},
"geocode": {
"latitude": "51.1076671",
"longitude": "-4.1607301"
}
},
"exceptionOperatingHours": [
{
"dateRange": {
"endDate": "1.6932672E9",
"startDate": "1.6931808E9"
},
"operatingHours": {
"closingTime": {
"hourOfDay": 0,
"minuteOfHour": 0,
"secondOfMinute": 0
},
"midDayClosures": [],
"openingTime": {
"hourOfDay": 0,
"minuteOfHour": 0,
"secondOfMinute": 0
}
}
}
],
"assistanceType": "STAFF_ASSISTED",
"score": "0.6688068509101868",
"standardOperatingHours": {
"WEDNESDAY": {
"closingTime": {
"hourOfDay": 22,
"minuteOfHour": 0,
"secondOfMinute": 0
},
"midDayClosures": [],
"openingTime": {
"hourOfDay": 7,
"minuteOfHour": 0,
"secondOfMinute": 0
}
},
"MONDAY": {
"closingTime": {
"hourOfDay": 22,
"minuteOfHour": 0,
"secondOfMinute": 0
},
"midDayClosures": [],
"openingTime": {
"hourOfDay": 7,
"minuteOfHour": 0,
"secondOfMinute": 0
}
},
"THURSDAY": {
"closingTime": {
"hourOfDay": 22,
"minuteOfHour": 0,
"secondOfMinute": 0
},
"midDayClosures": [],
"openingTime": {
"hourOfDay": 7,
"minuteOfHour": 0,
"secondOfMinute": 0
}
},
"SUNDAY": {
"closingTime": {
"hourOfDay": 22,
"minuteOfHour": 0,
"secondOfMinute": 0
},
"midDayClosures": [],
"openingTime": {
"hourOfDay": 7,
"minuteOfHour": 0,
"secondOfMinute": 0
}
},
"TUESDAY": {
"closingTime": {
"hourOfDay": 22,
"minuteOfHour": 0,
"secondOfMinute": 0
},
"midDayClosures": [],
"openingTime": {
"hourOfDay": 7,
"minuteOfHour": 0,
"secondOfMinute": 0
}
},
"FRIDAY": {
"closingTime": {
"hourOfDay": 22,
"minuteOfHour": 0,
"secondOfMinute": 0
},
"midDayClosures": [],
"openingTime": {
"hourOfDay": 7,
"minuteOfHour": 0,
"secondOfMinute": 0
}
},
"SATURDAY": {
"closingTime": {
"hourOfDay": 22,
"minuteOfHour": 0,
"secondOfMinute": 0
},
"midDayClosures": [],
"openingTime": {
"hourOfDay": 7,
"minuteOfHour": 0,
"secondOfMinute": 0
}
}
}
}
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InvalidRequest",
"message": "Request is missing or has invalid parameters",
"details": "Access Point types cannot be null"
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"401": {
"description": "The request's Authorization header is not formatted correctly or does not contain a valid token.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "Unauthorized",
"message": "You don't have access to the requested response or the credentials are invalid."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "Unauthorized",
"message": "You don't have access to the requested response or the credentials are invalid."
}
]
}
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"404": {
"description": "The resource specified does not exist.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "NotFound",
"message": "The requested resource is invalid or doesn't exist"
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InvalidRequest",
"message": "The request payload size is greater than maximum accepted size."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InvalidRequest",
"message": "The request payload format is not supported."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "TooManyRequests",
"message": "The total number of requests exceeded your allowed limit."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InternalError",
"message": "Something went wrong while processing the request."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "ServiceUnavailable",
"message": "Service temporarily unavailable or down for maintenance. Please try again after sometime."
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
}
},
"x-amzn-api-sandbox": {
"dynamic": {}
}
},
"parameters": []
},
"/shipping/v2/ndrFeedback": {
"post": {
"tags": [
"shipping"
],
"description": "This API submits the NDR (Non-delivery Report) Feedback for any eligible shipment.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 80 | 100 |\n\nThe `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 then those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).",
"operationId": "submitNdrFeedback",
"parameters": [
{
"in": "body",
"name": "body",
"description": "Request body for ndrFeedback operation",
"required": true,
"schema": {
"$ref": "#/definitions/SubmitNdrFeedbackRequest"
}
},
{
"name": "x-amzn-shipping-business-id",
"in": "header",
"description": "Amazon shipping business to assume for this request. The default is AmazonShipping_UK.",
"required": false,
"type": "string",
"enum": [
"AmazonShipping_US",
"AmazonShipping_IN",
"AmazonShipping_UK",
"AmazonShipping_UAE",
"AmazonShipping_SA",
"AmazonShipping_EG",
"AmazonShipping_IT",
"AmazonShipping_ES",
"AmazonShipping_FR",
"AmazonShipping_JP"
],
"x-docgen-enum-table-extension": [
{
"value": "AmazonShipping_US",
"description": "The United States Amazon shipping business."
},
{
"value": "AmazonShipping_IN",
"description": "The India Amazon shipping business."
},
{
"value": "AmazonShipping_UK",
"description": "The United Kingdom Amazon shipping business."
},
{
"value": "AmazonShipping_UAE",
"description": "The United Arab Emirates Amazon shipping business."
},
{
"value": "AmazonShipping_SA",
"description": "The Saudi Arabia Amazon shipping business."
},
{
"value": "AmazonShipping_EG",
"description": "The Egypt Amazon shipping business."
},
{
"value": "AmazonShipping_IT",
"description": "The Italy Amazon shipping business."
},
{
"value": "AmazonShipping_ES",
"description": "The Spain Amazon shipping business."
},
{
"value": "AmazonShipping_FR",
"description": "The France Amazon shipping business."
},
{
"value": "AmazonShipping_JP",
"description": "The Japan Amazon shipping business."
}
]
}
],
"responses": {
"204": {
"description": "Success",
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InvalidRequest",
"message": "Request is missing or has invalid parameters",
"details": "RescheduleDate is missing in the request"
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"401": {
"description": "The request's Authorization header is not formatted correctly or does not contain a valid token.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "Unauthorized",
"message": "You don't have access to the requested resource or the credentials are invalid."
}
]
}
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "Unauthorized",
"message": "You don't have access to the requested resource or the credentials are invalid."
}
]
}
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"404": {
"description": "The resource specified does not exist.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "NotFound",
"message": "The requested resource is invalid or doesn't exist"
}
]
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InvalidRequest",
"message": "The request payload size is greater than maximum accepted size."
}
]
}
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InvalidRequest",
"message": "The request payload format is not supported."
}
]
}
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "TooManyRequests",
"message": "The total number of requests exceeded your allowed limit."
}
]
}
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "InternalError",
"message": "Something went wrong while processing the request."
}
]
}
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"examples": {
"application/json": {
"errors": [
{
"code": "ServiceUnavailable",
"message": "Service temporarily unavailable or down for maintenance. Please try again after sometime."
}
]
}
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
}
},
"x-amzn-api-sandbox": {
"dynamic": {}
}
},
"parameters": []
}
},
"definitions": {
"Error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string",
"description": "An error code that identifies the type of error that occurred."
},
"message": {
"type": "string",
"description": "A message that describes the error condition."
},
"details": {
"type": "string",
"description": "Additional details that can help the caller understand or fix the issue."
}
},
"description": "Error response returned when the request is unsuccessful."
},
"ErrorList": {
"type": "object",
"description": "A list of error responses returned when a request is unsuccessful.",
"required": [
"errors"
],
"properties": {
"errors": {
"type": "array",
"items": {
"$ref": "#/definitions/Error"
}
}
}
},
"Weight": {
"description": "The weight in the units indicated.",
"type": "object",
"required": [
"unit",
"value"
],
"properties": {
"unit": {
"type": "string",
"description": "The unit of measurement.",
"enum": [
"GRAM",
"KILOGRAM",
"OUNCE",
"POUND"
],
"x-docgen-enum-table-extension": [
{
"value": "GRAM",
"description": "Metric unit of mass equal to one thousandth of a kilogram."
},
{
"value": "KILOGRAM",
"description": "Metric unit of mass."
},
{
"value": "OUNCE",
"description": "The imperial unit of weight that is one sixteenth of a pound."
},
{
"value": "POUND",
"description": "The imperial unit of weight."
}
]
},
"value": {
"type": "number",
"description": "The measurement value."
}
}
},
"LiquidVolume": {
"type": "object",
"required": [
"unit",
"value"
],
"properties": {
"unit": {
"type": "string",
"description": "The unit of measurement.",
"enum": [
"ML",
"L",
"FL_OZ",
"GAL",
"PT",
"QT",
"C"
],
"x-docgen-enum-table-extension": [
{
"value": "ML",
"description": "Milliliter - Metric unit of volume."
},
{
"value": "L",
"description": "Liter - Metric unit of volume."
},
{
"value": "FL_OZ",
"description": "Fluid Ounce - Imperial unit of volume."
},
{
"value": "GAL",
"description": "Gallon - Imperial unit of volume."
},
{
"value": "PT",
"description": "Pint - Imperial unit of volume."
},
{
"value": "QT",
"description": "Quart - Imperial unit of volume."
},
{
"value": "C",
"description": "Cup - Imperial unit of volume."
}
]
},
"value": {
"type": "number",
"description": "The measurement value."
}
},
"description": "Liquid Volume."
},
"InvoiceDetails": {
"description": "The invoice details for charges associated with the goods in the package. Only applies to certain regions.",
"type": "object",
"properties": {
"invoiceNumber": {
"type": "string",
"description": "The invoice number of the item."
},
"invoiceDate": {
"type": "string",
"format": "date-time",
"description": "The invoice date of the item in ISO 8061 format."
}
}
},
"ChargeList": {
"type": "array",
"description": "A list of charges based on the shipping service charges applied on a package.",
"items": {
"$ref": "#/definitions/ChargeComponent"
}
},
"ChargeComponent": {
"type": "object",
"description": "The type and amount of a charge applied on a package.",
"properties": {
"amount": {
"$ref": "#/definitions/Currency"
},
"chargeType": {
"type": "string",
"description": "The type of charge.",
"enum": [
"TAX",
"DISCOUNT"
],
"x-docgen-enum-table-extension": [
{
"value": "TAX",
"description": "A tax imposed on a package."
},
{
"value": "DISCOUNT",
"description": "A discount deducted from the cost of a package."
}
]
}
}
},
"Currency": {
"description": "The monetary value in the currency indicated, in ISO 4217 standard format.",
"type": "object",
"required": [
"unit",
"value"
],
"properties": {
"value": {
"type": "number",
"description": "The monetary value."
},
"unit": {
"type": "string",
"description": "The ISO 4217 format 3-character currency code.",
"minLength": 3,
"maxLength": 3
}
}
},
"Dimensions": {
"type": "object",
"required": [
"height",
"length",
"unit",
"width"
],
"properties": {
"length": {
"type": "number",
"description": "The length of the package."
},
"width": {
"type": "number",
"description": "The width of the package."
},
"height": {
"type": "number",
"description": "The height of the package."
},
"unit": {
"type": "string",
"description": "The unit of measurement.",
"enum": [
"INCH",
"CENTIMETER"
],
"x-docgen-enum-table-extension": [
{
"value": "INCH",
"description": "The imperial unit of length equal to one twelfth of a foot."
},
{
"value": "CENTIMETER",
"description": "A metric unit of length, equal to one hundredth of a meter."
}
]
}
},
"description": "A set of measurements for a three-dimensional object."
},
"RequestToken": {
"type": "string",
"description": "A unique token generated to identify a getRates operation."
},
"RateId": {
"type": "string",
"description": "An identifier for the rate (shipment offering) provided by a shipping service provider."
},
"CarrierId": {
"type": "string",
"description": "The carrier identifier for the offering, provided by the carrier."
},
"CarrierName": {
"type": "string",
"description": "The carrier name for the offering."
},
"PackageClientReferenceId": {
"type": "string",
"description": "A client provided unique identifier for a package being shipped. This value should be saved by the client to pass as a parameter to the getShipmentDocuments operation."
},
"ShipmentId": {
"type": "string",
"description": "The unique shipment identifier provided by a shipping service."
},
"DetailCodes": {
"type": "string",
"description": "A list of codes used to provide additional shipment information.",
"enum": [
"BusinessClosed",
"CustomerUnavailable",
"PaymentNotReady",
"OtpNotAvailable",
"DeliveryAttempted",
"UnableToAccess",
"UnableToContactRecipient",
"DeliveredToBehindWheelieBin",
"DeliveredToPorch",
"DeliveredToGarage",
"DeliveredToGarden",
"DeliveredToGreenhouse",
"DeliveredToMailSlot",
"DeliveredToMailRoom",
"DeliveredToNeighbor",
"DeliveredToRearDoor",
"DeliveredToReceptionist",
"DeliveredToShed",
"Signed",
"Damaged",
"IncorrectItems",
"NotRequired",
"Rejected",
"CancelledByRecipient",
"AddressNotFound",
"HazmatShipment",
"Undeliverable"
],
"x-docgen-enum-table-extension": [
{
"value": "BusinessClosed",
"description": "Attempted delivery but the business was closed."
},
{
"value": "CustomerUnavailable",
"description": "Attempted delivery but the recipient was unavailable."
},
{
"value": "PaymentNotReady",
"description": "Attempted delivery but cash was not available from recipient."
},
{
"value": "OtpNotAvailable",
"description": "Attempted delivery but the recipient did not have the PIN available."
},
{
"value": "DeliveryAttempted",
"description": "Delivery was attempted."
},
{
"value": "UnableToAccess",
"description": "Attempted delivery but could not access the recipient location."
},
{
"value": "UnableToContactRecipient",
"description": "Attempted delivery but unable to contact the recipient to coordinate delivery."
},
{
"value": "DeliveredToBehindWheelieBin",
"description": "Shipment delivered behind wheelie bin."
},
{
"value": "DeliveredToPorch",
"description": "Shipment delivered to front porch or front door."
},
{
"value": "DeliveredToGarage",
"description": "Shipment delivered to garage."
},
{
"value": "DeliveredToGarden",
"description": "Shipment delivered to garden."
},
{
"value": "DeliveredToGreenhouse",
"description": "Shipment delivered to greenhouse."
},
{
"value": "DeliveredToMailSlot",
"description": "Shipment delivered to letterbox/mail slot."
},
{
"value": "DeliveredToMailRoom",
"description": "Shipment delivered to mailroom."
},
{
"value": "DeliveredToNeighbor",
"description": "Shipment delivered and signed for by neighbor."
},
{
"value": "DeliveredToRearDoor",
"description": "Shipment delivered to rear porch or rear door."
},
{
"value": "DeliveredToReceptionist",
"description": "Shipment delivered to reception."
},
{
"value": "DeliveredToShed",
"description": "Shipment delivered to shed."
},
{
"value": "Signed",
"description": "Shipment delivered and signature received."
},
{
"value": "Damaged",
"description": "Shipment was damaged. When paired with Rejected this indicates the recipient refused to accept the shipment because the shipment was damaged. When paired with UNDELIVERABLE it means the shipment was undeliverable due to being damaged and may be returned to the seller."
},
{
"value": "IncorrectItems",
"description": "Recipient refused to accept the shipment because the shipment contains incorrect item/s."
},
{
"value": "NotRequired",
"description": "Recipient refused to accept the shipment because the recipient did not want the shipment."
},
{
"value": "Rejected",
"description": "Recipient refused to accept the shipment."
},
{
"value": "CancelledByRecipient",
"description": "Shipment was cancelled by the recipient. This tag is paired with the rejected shipment status."
},
{
"value": "AddressNotFound",
"description": "Shipment is undeliverable and is returning to seller because the address was missing or incorrect."
},
{
"value": "HazmatShipment",
"description": "Shipment is non-compliant Hazmat."
},
{
"value": "Undeliverable",
"description": "Shipment is undeliverable and is returning to the seller."
}
]
},
"TrackingDetailCodes": {
"type":"object",
"description": "Contains detail codes that provide additional details related to the forward and return leg of the shipment.",
"required": [
"forward",
"returns"
],
"properties": {
"forward": {
"type": "array",
"description": "Contains detail codes that provide additional details related to the forward leg of the shipment.",
"items": {
"$ref": "#/definitions/DetailCodes"
}
},
"returns": {
"type": "array",
"description": "Contains detail codes that provide additional details related to the return leg of the shipment.",
"items": {
"$ref": "#/definitions/DetailCodes"
}
}
}
},
"TrackingId": {
"type": "string",
"description": "The carrier generated identifier for a package in a purchased shipment."
},
"AlternateLegTrackingId": {
"type": "string",
"description": "The carrier generated reverse identifier for a returned package in a purchased shipment."
},
"ServiceId": {
"type": "string",
"description": "An identifier for the shipping service."
},
"ServiceName": {
"type": "string",
"description": "The name of the shipping service."
},
"AdditionalAddressNotes": {
"type": "string",
"maxLength": 256,
"description": "Address notes to re-attempt delivery with."
},
"ShipperInstruction": {
"type": "object",
"properties": {
"deliveryNotes": {
"type": "string",
"description": "The delivery notes for the shipment",
"maxLength": 256
}
},
"description": "The shipper instruction."
},
"Address": {
"type": "object",
"required": [
"addressLine1",
"city",
"countryCode",
"name",
"postalCode",
"stateOrRegion"
],
"properties": {
"name": {
"type": "string",
"description": "The name of the person, business or institution at the address.",
"minLength": 1,
"maxLength": 50
},
"addressLine1": {
"type": "string",
"description": "The first line of the address.",
"minLength": 1,
"maxLength": 60
},
"addressLine2": {
"type": "string",
"description": "Additional address information, if required.",
"minLength": 1,
"maxLength": 60
},
"addressLine3": {
"type": "string",
"description": "Additional address information, if required.",
"minLength": 1,
"maxLength": 60
},
"companyName": {
"type": "string",
"description": "The name of the business or institution associated with the address."
},
"stateOrRegion": {
"$ref": "#/definitions/StateOrRegion"
},
"city": {
"$ref": "#/definitions/City"
},
"countryCode": {
"$ref": "#/definitions/CountryCode"
},
"postalCode": {
"$ref": "#/definitions/PostalCode"
},
"email": {
"type": "string",
"description": "The email address of the contact associated with the address.",
"maxLength": 64
},
"phoneNumber": {
"type": "string",
"description": "The phone number of the person, business or institution located at that address, including the country calling code.",
"minLength": 1,
"maxLength": 20
},
"geocode": {
"$ref": "#/definitions/Geocode"
}
},
"description": "The address."
},
"Geocode": {
"type": "object",
"description": "Defines the latitude and longitude of the access point.",
"properties": {
"latitude": {
"description": "The latitude of access point.",
"type": "string"
},
"longitude": {
"description": "The longitude of access point.",
"type": "string"
}
}
},
"StateOrRegion": {
"type": "string",
"description": "The state, county or region where the person, business or institution is located."
},
"City": {
"type": "string",
"description": "The city or town where the person, business or institution is located."
},
"CountryCode": {
"type": "string",
"description": "The two digit country code. Follows ISO 3166-1 alpha-2 format."
},
"PostalCode": {
"type": "string",
"description": "The postal code of that address. It contains a series of letters or digits or both, sometimes including spaces or punctuation."
},
"Location": {
"type": "object",
"properties": {
"stateOrRegion": {
"$ref": "#/definitions/StateOrRegion"
},
"city": {
"$ref": "#/definitions/City"
},
"countryCode": {
"$ref": "#/definitions/CountryCode"
},
"postalCode": {
"$ref": "#/definitions/PostalCode"
}
},
"description": "The location where the person, business or institution is located."
},
"DocumentFormat": {
"type": "string",
"description": "The file format of the document.",
"enum": [
"PDF",
"PNG",
"ZPL"
],
"x-docgen-enum-table-extension": [
{
"value": "PDF",
"description": "The Portable Document Format (PDF) file format. Used to present documents, including text formatting and images, in a manner independent of application software, hardware, and operating systems."
},
{
"value": "PNG",
"description": "Portable Network Graphics (PNG) is a raster-graphics file format that supports lossless data compression."
},
{
"value": "ZPL",
"description": "Zebra Programming Language (ZPL) format is from Zebra Technologies. It's used primarily for labeling applications and can only be used with ZPL compatible printers."
}
]
},
"DocumentType": {
"type": "string",
"description": "The type of shipping document.",
"enum": [
"PACKSLIP",
"LABEL",
"RECEIPT",
"CUSTOM_FORM"
],
"x-docgen-enum-table-extension": [
{
"value": "PACKSLIP",
"description": "A listing of the items packed within the shipment."
},
{
"value": "LABEL",
"description": "The shipping label for the specific shipment."
},
{
"value": "RECEIPT",
"description": "The receipt of the shipment."
},
{
"value": "CUSTOM_FORM",
"description": "The customs documentation for a cross-border shipment."
}
]
},
"Dpi": {
"type": "integer",
"description": "The dots per inch (DPI) value used in printing. This value represents a measure of the resolution of the document."
},
"PageLayout": {
"type": "string",
"description": "Indicates the position of the label on the paper. Should be the same value as returned in getRates response."
},
"NeedFileJoining": {
"type": "boolean",
"description": "When true, files should be stitched together. Otherwise, files should be returned separately. Defaults to false."
},
"Contents": {
"type": "string",
"description": "A Base64 encoded string of the file contents."
},
"PackageDocumentList": {
"type": "array",
"description": "A list of documents related to a package.",
"items": {
"$ref": "#/definitions/PackageDocument"
}
},
"PackageDocument": {
"type": "object",
"required": [
"contents",
"format",
"type"
],
"properties": {
"type": {
"$ref": "#/definitions/DocumentType"
},
"format": {
"$ref": "#/definitions/DocumentFormat"
},
"contents": {
"$ref": "#/definitions/Contents"
}
},
"description": "A document related to a package."
},
"PrintOptionList": {
"type": "array",
"description": "A list of the format options for a label.",
"items": {
"$ref": "#/definitions/PrintOption"
}
},
"PrintOption": {
"type": "object",
"required": [
"supportedDocumentDetails",
"supportedFileJoiningOptions",
"supportedPageLayouts"
],
"properties": {
"supportedDPIs": {
"type": "array",
"description": "A list of the supported DPI options for a document.",
"items": {
"$ref": "#/definitions/Dpi"
}
},
"supportedPageLayouts": {
"type": "array",
"description": "A list of the supported page layout options for a document.",
"items": {
"$ref": "#/definitions/PageLayout"
}
},
"supportedFileJoiningOptions": {
"type": "array",
"description": "A list of the supported needFileJoining boolean values for a document.",
"items": {
"$ref": "#/definitions/NeedFileJoining"
}
},
"supportedDocumentDetails": {
"description": "A list of the supported documented details.",
"type": "array",
"items": {
"$ref": "#/definitions/SupportedDocumentDetail"
}
}
},
"description": "The format options available for a label."
},
"DocumentSize": {
"type": "object",
"required": [
"length",
"unit",
"width"
],
"properties": {
"width": {
"description": "The width of the document measured in the units specified.",
"type": "number"
},
"length": {
"description": "The length of the document measured in the units specified.",
"type": "number"
},
"unit": {
"type": "string",
"description": "The unit of measurement.",
"enum": [
"INCH",
"CENTIMETER"
],
"x-docgen-enum-table-extension": [
{
"value": "INCH",
"description": "The imperial unit of length equal to one twelfth of a foot."
},
{
"value": "CENTIMETER",
"description": "A metric unit of length, equal to one hundredth of a meter."
}
]
}
},
"description": "The size dimensions of the label."
},
"SupportedDocumentDetail": {
"type": "object",
"required": [
"isMandatory",
"name"
],
"properties": {
"name": {
"$ref": "#/definitions/DocumentType"
},
"isMandatory": {
"type": "boolean",
"description": "When true, the supported document type is required."
}
},
"description": "The supported document types for a service offering."
},
"RequestedDocumentSpecification": {
"type": "object",
"required": [
"format",
"needFileJoining",
"requestedDocumentTypes",
"size"
],
"properties": {
"format": {
"$ref": "#/definitions/DocumentFormat"
},
"size": {
"$ref": "#/definitions/DocumentSize"
},
"dpi": {
"$ref": "#/definitions/Dpi"
},
"pageLayout": {
"$ref": "#/definitions/PageLayout"
},
"needFileJoining": {
"$ref": "#/definitions/NeedFileJoining"
},
"requestedDocumentTypes": {
"description": "A list of the document types requested.",
"type": "array",
"items": {
"$ref": "#/definitions/DocumentType"
}
}
},
"description": "The document specifications requested. For calls to the purchaseShipment operation, the shipment purchase fails if the specified document specifications are not among those returned in the response to the getRates operation."
},
"SupportedDocumentSpecificationList": {
"type": "array",
"description": "A list of the document specifications supported for a shipment service offering.",
"items": {
"$ref": "#/definitions/SupportedDocumentSpecification"
}
},
"SupportedDocumentSpecification": {
"type": "object",
"required": [
"format",
"printOptions",
"size"
],
"properties": {
"format": {
"$ref": "#/definitions/DocumentFormat"
},
"size": {
"$ref": "#/definitions/DocumentSize"
},
"printOptions": {
"$ref": "#/definitions/PrintOptionList"
}
},
"description": "Document specification that is supported for a service offering."
},
"Item": {
"type": "object",
"required": [
"quantity"
],
"properties": {
"itemValue": {
"$ref": "#/definitions/Currency"
},
"description": {
"type": "string",
"description": "The product description of the item."
},
"itemIdentifier": {
"type": "string",
"description": "A unique identifier for an item provided by the client."
},
"quantity": {
"type": "integer",
"description": "The number of units. This value is required."
},
"weight": {
"$ref": "#/definitions/Weight"
},
"liquidVolume": {
"$ref": "#/definitions/LiquidVolume"
},
"isHazmat": {
"type": "boolean",
"description": "When true, the item qualifies as hazardous materials (hazmat). Defaults to false."
},
"dangerousGoodsDetails": {
"$ref": "#/definitions/DangerousGoodsDetails"
},
"productType": {
"type": "string",
"description": "The product type of the item."
},
"invoiceDetails": {
"$ref": "#/definitions/InvoiceDetails"
},
"serialNumbers": {
"type": "array",
"items": {
"type": "string"
},
"description": "A list of unique serial numbers in an Amazon package that can be used to guarantee non-fraudulent items. The number of serial numbers in the list must be less than or equal to the quantity of items being shipped. Only applicable when channel source is Amazon."
},
"directFulfillmentItemIdentifiers": {
"$ref": "#/definitions/DirectFulfillmentItemIdentifiers"
}
},
"description": "An item in a package."
},
"ItemList": {
"type": "array",
"description": "A list of items.",
"items": {
"$ref": "#/definitions/Item"
}
},
"Package": {
"type": "object",
"required": [
"dimensions",
"insuredValue",
"items",
"packageClientReferenceId",
"weight"
],
"properties": {
"dimensions": {
"$ref": "#/definitions/Dimensions"
},
"weight": {
"$ref": "#/definitions/Weight"
},
"insuredValue": {
"$ref": "#/definitions/Currency"
},
"isHazmat": {
"type": "boolean",
"description": "When true, the package contains hazardous materials. Defaults to false."
},
"sellerDisplayName": {
"type": "string",
"description": "The seller name displayed on the label."
},
"charges": {
"$ref": "#/definitions/ChargeList"
},
"packageClientReferenceId": {
"$ref": "#/definitions/PackageClientReferenceId"
},
"items": {
"$ref": "#/definitions/ItemList"
}
},
"description": "A package to be shipped through a shipping service offering."
},
"PackageList": {
"type": "array",
"description": "A list of packages to be shipped through a shipping service offering.",
"items": {
"$ref": "#/definitions/Package"
}
},
"DirectFulfillmentItemIdentifiers": {
"type": "object",
"required": [
"lineItemID"
],
"properties": {
"lineItemID": {
"type": "string",
"description": "A unique identifier for an item provided by the client for a direct fulfillment shipment. This is only populated for direct fulfillment multi-piece shipments. It is required if a vendor wants to change the configuration of the packages in which the purchase order is shipped."
},
"pieceNumber": {
"type": "string",
"description": "A unique identifier for an item provided by the client for a direct fulfillment shipment. This is only populated if a single line item has multiple pieces. Defaults to 1."
}
},
"description": "Item identifiers for an item in a direct fulfillment shipment."
},
"PackageDocumentDetail": {
"type": "object",
"required": [
"packageClientReferenceId",
"packageDocuments"
],
"properties": {
"packageClientReferenceId": {
"$ref": "#/definitions/PackageClientReferenceId"
},
"packageDocuments": {
"$ref": "#/definitions/PackageDocumentList"
},
"trackingId": {
"$ref": "#/definitions/TrackingId"
}
},
"description": "The post-purchase details of a package that will be shipped using a shipping service."
},
"PackageDocumentDetailList": {
"type": "array",
"description": "A list of post-purchase details about a package that will be shipped using a shipping service.",
"items": {
"$ref": "#/definitions/PackageDocumentDetail"
}
},
"TimeWindow": {
"type": "object",
"properties": {
"start": {
"type": "string",
"format": "date-time",
"description": "The start time of the time window."
},
"end": {
"type": "string",
"format": "date-time",
"description": "The end time of the time window."
}
},
"description": "The start and end time that specifies the time interval of an event."
},
"Promise": {
"type": "object",
"properties": {
"deliveryWindow": {
"$ref": "#/definitions/TimeWindow"
},
"pickupWindow": {
"$ref": "#/definitions/TimeWindow"
}
},
"description": "The time windows promised for pickup and delivery events."
},
"RequestedValueAddedServiceList": {
"type": "array",
"description": "The value-added services to be added to a shipping service purchase.",
"items": {
"$ref": "#/definitions/RequestedValueAddedService"
}
},
"RequestedValueAddedService": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The identifier of the selected value-added service. Must be among those returned in the response to the getRates operation."
}
},
"description": "A value-added service to be applied to a shipping service purchase."
},
"AvailableValueAddedServiceGroupList": {
"type": "array",
"description": "A list of value-added services available for a shipping service offering.",
"items": {
"$ref": "#/definitions/AvailableValueAddedServiceGroup"
}
},
"AvailableValueAddedServiceGroup": {
"type": "object",
"required": [
"groupDescription",
"groupId",
"isRequired"
],
"properties": {
"groupId": {
"type": "string",
"description": "The type of the value-added service group."
},
"groupDescription": {
"type": "string",
"description": "The name of the value-added service group."
},
"isRequired": {
"type": "boolean",
"description": "When true, one or more of the value-added services listed must be specified."
},
"valueAddedServices": {
"type": "array",
"description": "A list of optional value-added services available for purchase with a shipping service offering.",
"items": {
"$ref": "#/definitions/ValueAddedService"
}
}
},
"description": "The value-added services available for purchase with a shipping service offering."
},
"ValueAddedService": {
"type": "object",
"required": [
"cost",
"id",
"name"
],
"properties": {
"id": {
"type": "string",
"description": "The identifier for the value-added service."
},
"name": {
"type": "string",
"description": "The name of the value-added service."
},
"cost": {
"description": "The cost of the value-added service.",
"$ref": "#/definitions/Currency"
}
},
"description": "A value-added service available for purchase with a shipment service offering."
},
"CollectOnDelivery": {
"type": "object",
"required": [
"amount"
],
"properties": {
"amount": {
"$ref": "#/definitions/Currency"
}
},
"description": "The amount to collect on delivery."
},
"ValueAddedServiceDetails": {
"type": "object",
"properties": {
"collectOnDelivery": {
"$ref": "#/definitions/CollectOnDelivery"
}
},
"description": "A collection of supported value-added services."
},
"DangerousGoodsDetails": {
"type": "object",
"properties": {
"unitedNationsRegulatoryId" : {
"type": "string",
"description": "The specific UNID of the item being shipped.",
"pattern" : "^(UN|ID|NA)[0-9]{4}$"
},
"transportationRegulatoryClass" : {
"type": "string",
"description": "The specific regulatory class of the item being shipped.",
"pattern": "^[1-9](\\.[1-9])?$"
},
"packingGroup" : {
"type": "string",
"description": "The specific packaging group of the item being shipped.",
"enum": [
"I",
"II",
"III"
],
"x-docgen-enum-table-extension": [
{
"value": "I",
"description": "Packing group I indicates great danger."
},
{
"value": "II",
"description": "Packing group II indicates medium danger."
},
{
"value": "III",
"description": "Packing group III indicates minor danger."
}
]
},
"packingInstruction": {
"type": "string",
"description": "The specific packing instruction of the item being shipped.",
"enum": [
"PI965_SECTION_IA",
"PI965_SECTION_IB",
"PI965_SECTION_II",
"PI966_SECTION_I",
"PI966_SECTION_II",
"PI967_SECTION_I",
"PI967_SECTION_II",
"PI968_SECTION_IA",
"PI968_SECTION_IB",
"PI969_SECTION_I",
"PI969_SECTION_II",
"PI970_SECTION_I",
"PI970_SECTION_II"
],
"x-docgen-enum-table-extension": [
{
"value": "PI965_SECTION_IA",
"description": "Ion PI965 Section IA (LiBa)"
},
{
"value": "PI965_SECTION_IB",
"description": "Ion PI965 Section IB (LiBa)"
},
{
"value": "PI965_SECTION_II",
"description": "Ion PI965 Section II (LiBa)"
},
{
"value": "PI966_SECTION_I",
"description": "Ion PI966 Section I (LiBa with equipment)"
},
{
"value": "PI966_SECTION_II",
"description": "Ion PI966 Section II (LiBa with equipment)"
},
{
"value": "PI967_SECTION_I",
"description": "Ion PI967 Section I (LiBa in equipment)"
},
{
"value": "PI967_SECTION_II",
"description": "Ion PI967 Section II (LiBa in equipment)"
},
{
"value": "PI968_SECTION_IA",
"description": "Metal PI968 Section IA (LiBa)"
},
{
"value": "PI968_SECTION_IB",
"description": "Metal PI968 Section IB (LiBa)"
},
{
"value": "PI969_SECTION_I",
"description": "Metal PI969 Section I (LiBa with equipment)"
},
{
"value": "PI969_SECTION_II",
"description": "Metal PI969 Section II (LiBa with equipment)"
},
{
"value": "PI970_SECTION_I",
"description": "Metal PI970 Section I (LiBa in equipment)"
},
{
"value": "PI970_SECTION_II",
"description": "Metal PI970 Section II (LiBa in equipment)"
}
]
}
},
"description": "Details related to any dangerous goods/items that are being shipped."
},
"TaxType": {
"type": "string",
"description": "Indicates the type of tax.",
"enum": [
"GST"
],
"x-docgen-enum-table-extension": [
{
"value": "GST",
"description": "Goods and Services Tax."
}
]
},
"TaxDetail": {
"description": "Indicates the tax specifications associated with the shipment for customs compliance purposes in certain regions.",
"type": "object",
"required": [
"taxRegistrationNumber",
"taxType"
],
"properties": {
"taxType": {
"$ref": "#/definitions/TaxType"
},
"taxRegistrationNumber": {
"description": "The shipper's tax registration number associated with the shipment for customs compliance purposes in certain regions.",
"type": "string"
}
}
},
"TaxDetailList": {
"type": "array",
"description": "A list of tax detail information.",
"items": {
"$ref": "#/definitions/TaxDetail"
}
},
"EventCode": {
"type": "string",
"description": "The tracking event type.",
"enum": [
"ReadyForReceive",
"PickupDone",
"Delivered",
"Departed",
"DeliveryAttempted",
"Lost",
"OutForDelivery",
"ArrivedAtCarrierFacility",
"Rejected",
"Undeliverable",
"PickupCancelled",
"ReturnInitiated",
"AvailableForPickup"
],
"x-docgen-enum-table-extension": [
{
"value": "ReadyForReceive",
"description": "Package has been created and is ready for pickup at the shippers location. This is a pre-transit status event code."
},
{
"value": "PickupDone",
"description": "Package has been picked up by the service provider."
},
{
"value": "Delivered",
"description": "Package has been delivered."
},
{
"value": "Departed",
"description": "Package has departed from a particular location in carrier network."
},
{
"value": "DeliveryAttempted",
"description": "Delivery was attempted, but was unsuccessful."
},
{
"value": "Lost",
"description": "Package is lost."
},
{
"value": "OutForDelivery",
"description": "Package is out for delivery."
},
{
"value": "ArrivedAtCarrierFacility",
"description": "Package is in transit and has been received at a carrier location."
},
{
"value": "Rejected",
"description": "Package was rejected by the recipient."
},
{
"value": "Undeliverable",
"description": "Package is undeliverable."
},
{
"value": "PickupCancelled",
"description": "Pickup scheduled for the package was cancelled."
},
{
"value": "ReturnInitiated",
"description": "Return label has been generated."
},
{
"value": "AvailableForPickup",
"description": "Package held for recipient pickup."
}
]
},
"Event": {
"type": "object",
"required": [
"eventCode",
"eventTime"
],
"properties": {
"eventCode": {
"$ref": "#/definitions/EventCode"
},
"location": {
"$ref": "#/definitions/Location"
},
"eventTime": {
"type": "string",
"format": "date-time",
"description": "The ISO 8601 formatted timestamp of the event."
},
"shipmentType": {
"$ref": "#/definitions/ShipmentType"
}
},
"description": "A tracking event."
},
"TrackingSummary": {
"type": "object",
"properties": {
"status": {
"$ref": "#/definitions/Status"
},
"trackingDetailCodes": {
"$ref": "#/definitions/TrackingDetailCodes"
}
},
"description": "A package status summary."
},
"Status": {
"type": "string",
"description": "The status of the package being shipped.",
"enum": [
"PreTransit",
"InTransit",
"Delivered",
"Lost",
"OutForDelivery",
"Rejected",
"Undeliverable",
"DeliveryAttempted",
"PickupCancelled",
"AwaitingCustomerPickup"
],
"x-docgen-enum-table-extension": [
{
"value": "PreTransit",
"description": "Package has been created but has not been picked up."
},
{
"value": "InTransit",
"description": "Package has been picked up and is in transit."
},
{
"value": "Delivered",
"description": "Package has has been delivered successfully."
},
{
"value": "Lost",
"description": "Package is lost."
},
{
"value": "OutForDelivery",
"description": "Package is out for delivery."
},
{
"value": "Rejected",
"description": "Package has been rejected by the recipient."
},
{
"value": "Undeliverable",
"description": "Package was undeliverable."
},
{
"value": "DeliveryAttempted",
"description": "Delivery was attempted to the recipient location, but was not delivered."
},
{
"value": "PickupCancelled",
"description": "Pickup was cancelled for the package."
},
{
"value": "AwaitingCustomerPickup",
"description": "Package held at facility for the customer pickup."
}
]
},
"AmazonOrderDetails": {
"type": "object",
"required": [
"orderId"
],
"properties": {
"orderId": {
"type": "string",
"description": "The Amazon order ID associated with the Amazon order fulfilled by this shipment."
}
},
"description": "Amazon order information. This is required if the shipment source channel is Amazon."
},
"AmazonShipmentDetails": {
"type": "object",
"required": [
"shipmentId"
],
"properties": {
"shipmentId": {
"type": "string",
"description": "This attribute is required only for a Direct Fulfillment shipment. This is the encrypted shipment ID."
}
},
"description": "Amazon shipment information."
},
"ChannelType": {
"type": "string",
"description": "The shipment source channel type.",
"enum": [
"AMAZON",
"EXTERNAL"
],
"x-docgen-enum-table-extension": [
{
"value": "AMAZON",
"description": "Indicates that the shipment originates from an Amazon order."
},
{
"value": "EXTERNAL",
"description": "Indicates that the shipment originates from a non-Amazon channel."
}
]
},
"ChannelDetails": {
"type": "object",
"required": [
"channelType"
],
"properties": {
"channelType": {
"$ref": "#/definitions/ChannelType"
},
"amazonOrderDetails": {
"$ref": "#/definitions/AmazonOrderDetails"
},
"amazonShipmentDetails": {
"$ref": "#/definitions/AmazonShipmentDetails"
}
},
"description": "Shipment source channel related information."
},
"RateList": {
"type": "array",
"description": "A list of eligible shipping service offerings.",
"items": {
"$ref": "#/definitions/Rate"
}
},
"Rate": {
"type": "object",
"required": [
"carrierId",
"carrierName",
"promise",
"rateId",
"requiresAdditionalInputs",
"serviceId",
"serviceName",
"supportedDocumentSpecifications",
"totalCharge"
],
"properties": {
"rateId": {
"$ref": "#/definitions/RateId"
},
"carrierId": {
"$ref": "#/definitions/CarrierId"
},
"carrierName": {
"$ref": "#/definitions/CarrierName"
},
"serviceId": {
"$ref": "#/definitions/ServiceId"
},
"serviceName": {
"$ref": "#/definitions/ServiceName"
},
"billedWeight": {
"$ref": "#/definitions/Weight"
},
"totalCharge": {
"$ref": "#/definitions/Currency"
},
"promise": {
"$ref": "#/definitions/Promise"
},
"supportedDocumentSpecifications": {
"$ref": "#/definitions/SupportedDocumentSpecificationList"
},
"availableValueAddedServiceGroups": {
"$ref": "#/definitions/AvailableValueAddedServiceGroupList"
},
"requiresAdditionalInputs": {
"type": "boolean",
"description" : "When true, indicates that additional inputs are required to purchase this shipment service. You must then call the getAdditionalInputs operation to return the JSON schema to use when providing the additional inputs to the purchaseShipment operation."
},
"rateItemList": {
"$ref": "#/definitions/RateItemList"
},
"paymentType": {
"$ref": "#/definitions/PaymentType"
},
"benefits": {
"$ref": "#/definitions/Benefits"
}
},
"description": "The details of a shipping service offering."
},
"IneligibilityReasonCode": {
"type": "string",
"description": "Reasons that make a shipment service offering ineligible.",
"enum": [
"NO_COVERAGE",
"PICKUP_SLOT_RESTRICTION",
"UNSUPPORTED_VAS",
"VAS_COMBINATION_RESTRICTION",
"SIZE_RESTRICTIONS",
"WEIGHT_RESTRICTIONS",
"LATE_DELIVERY",
"PROGRAM_CONSTRAINTS",
"TERMS_AND_CONDITIONS_NOT_ACCEPTED",
"UNKNOWN"
],
"x-docgen-enum-table-extension": [
{
"value": "NO_COVERAGE",
"description": "The shipment is ineligible because there is no coverage to that address."
},
{
"value": "PICKUP_SLOT_RESTRICTION",
"description": "The shipment is ineligible because there is an issue with the pickup slot."
},
{
"value": "UNSUPPORTED_VAS",
"description": "The shipment is ineligible because the value-added service is invalid for this shipment."
},
{
"value": "VAS_COMBINATION_RESTRICTION",
"description": "The shipment is ineligible because an invalid combination of value-added services were chosen."
},
{
"value": "SIZE_RESTRICTIONS",
"description": "The shipment is ineligible because the package dimensions are unsupported."
},
{
"value": "WEIGHT_RESTRICTIONS",
"description": "The shipment is ineligible because the weight is unsupported."
},
{
"value": "LATE_DELIVERY",
"description": "The shipment is ineligible because delivery is too late."
},
{
"value": "PROGRAM_CONSTRAINTS",
"description": "The shipment is ineligible because of program constraints."
},
{
"value": "TERMS_AND_CONDITIONS_NOT_ACCEPTED",
"description": "The shipment is ineligible because terms and conditions have not been accepted by the carrier."
},
{
"value": "UNKNOWN",
"description": "The ineligibility reason is unknown."
}
]
},
"IneligibilityReason" : {
"description": "The reason why a shipping service offering is ineligible.",
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"$ref": "#/definitions/IneligibilityReasonCode"
},
"message": {
"type": "string",
"description": "The ineligibility reason."
}
}
},
"IneligibleRate": {
"description": "Detailed information for an ineligible shipping service offering.",
"type": "object",
"required": [
"carrierId",
"carrierName",
"ineligibilityReasons",
"serviceId",
"serviceName"
],
"properties": {
"serviceId": {
"$ref": "#/definitions/ServiceId"
},
"serviceName": {
"$ref": "#/definitions/ServiceName"
},
"carrierName": {
"$ref": "#/definitions/CarrierName"
},
"carrierId": {
"$ref": "#/definitions/CarrierId"
},
"ineligibilityReasons": {
"type": "array",
"description": "A list of reasons why a shipping service offering is ineligible.",
"items": {
"$ref": "#/definitions/IneligibilityReason"
}
}
}
},
"IneligibleRateList": {
"type": "array",
"description": "A list of ineligible shipping service offerings.",
"items": {
"$ref": "#/definitions/IneligibleRate"
}
},
"CancelShipmentResult": {
"type": "object",
"description": "The payload for the cancelShipment operation.",
"additionalProperties": {}
},
"CancelShipmentResponse": {
"type": "object",
"properties": {
"payload": {
"$ref": "#/definitions/CancelShipmentResult"
}
},
"description": "Response schema for the cancelShipment operation."
},
"GetRatesRequest": {
"description": "The request schema for the getRates operation. When the channelType is Amazon, the shipTo address is not required and will be ignored.",
"type": "object",
"required": [
"channelDetails",
"packages",
"shipFrom"
],
"properties": {
"shipTo": {
"description": "The ship to address.",
"$ref": "#/definitions/Address"
},
"shipFrom": {
"description": "The ship from address.",
"$ref": "#/definitions/Address"
},
"returnTo": {
"description": "The return to address.",
"$ref": "#/definitions/Address"
},
"shipDate": {
"type": "string",
"format": "date-time",
"description": "The ship date and time (the requested pickup). This defaults to the current date and time."
},
"shipperInstruction": {
"$ref": "#/definitions/ShipperInstruction",
"description": "This field describe shipper instruction."
},
"packages": {
"$ref": "#/definitions/PackageList"
},
"valueAddedServices": {
"$ref": "#/definitions/ValueAddedServiceDetails"
},
"taxDetails": {
"$ref": "#/definitions/TaxDetailList"
},
"channelDetails": {
"$ref": "#/definitions/ChannelDetails"
},
"clientReferenceDetails": {
"$ref": "#/definitions/ClientReferenceDetails"
},
"shipmentType": {
"$ref": "#/definitions/ShipmentType"
},
"destinationAccessPointDetails": {
"$ref": "#/definitions/AccessPointDetails"
}
}
},
"AccessPointDetails": {
"type": "object",
"properties": {
"accessPointId": {
"$ref": "#/definitions/AccessPointId"
}
}
},
"NdrAction": {
"type": "string",
"description": "The type of NDR action shipper wants to take for a particular shipment.",
"enum": [
"RESCHEDULE",
"REATTEMPT",
"RTO"
],
"x-docgen-enum-table-extension": [
{
"value": "RESCHEDULE",
"description": "Seller wants to reschedule shipment delivery to a specific date."
},
{
"value": "REATTEMPT",
"description": "Seller wants to re-attempt delivery with additional delivery notes."
},
{
"value": "RTO",
"description": "Seller wants the shipment to return to the origin."
}
]
},
"NdrRequestData": {
"type": "object",
"description": "Additional information required for the NDR action that has been filed. If the NDR Action is RESCHEDULE, rescheduleDate is a required field. Otherwise, if the NDR Action is REATTEMPT, additionalAddressNotes is a required field. ",
"properties": {
"rescheduleDate": {
"type": "string",
"format": "date-time",
"description": "The date on which the Seller wants to reschedule shipment delivery, in ISO-8601 date/time format",
"example": "2023-12-12T05:24:00.00Z"
},
"additionalAddressNotes": {
"$ref": "#/definitions/AdditionalAddressNotes"
}
}
},
"GetRatesResult": {
"type": "object",
"required": [
"rates",
"requestToken"
],
"properties": {
"requestToken": {
"$ref": "#/definitions/RequestToken"
},
"rates": {
"$ref": "#/definitions/RateList"
},
"ineligibleRates": {
"$ref": "#/definitions/IneligibleRateList"
}
},
"description": "The payload for the getRates operation."
},
"GetRatesResponse": {
"type": "object",
"properties": {
"payload": {
"$ref": "#/definitions/GetRatesResult"
}
},
"description": "The response schema for the getRates operation."
},
"GetShipmentDocumentsResult": {
"type": "object",
"required": [
"packageDocumentDetail",
"shipmentId"
],
"properties": {
"shipmentId": {
"$ref": "#/definitions/ShipmentId"
},
"packageDocumentDetail": {
"$ref": "#/definitions/PackageDocumentDetail"
}
},
"description": "The payload for the getShipmentDocuments operation."
},
"GetShipmentDocumentsResponse": {
"type": "object",
"properties": {
"payload": {
"$ref": "#/definitions/GetShipmentDocumentsResult"
}
},
"description": "The response schema for the the getShipmentDocuments operation."
},
"GetTrackingResult": {
"type": "object",
"required": [
"eventHistory",
"promisedDeliveryDate",
"summary",
"trackingId",
"alternateLegTrackingId"
],
"properties": {
"trackingId": {
"$ref": "#/definitions/TrackingId"
},
"alternateLegTrackingId": {
"$ref": "#/definitions/AlternateLegTrackingId"
},
"eventHistory": {
"type": "array",
"description": "A list of tracking events.",
"items": {
"$ref": "#/definitions/Event"
}
},
"promisedDeliveryDate": {
"type": "string",
"format": "date-time",
"description": "The date and time by which the shipment is promised to be delivered."
},
"summary": {
"$ref": "#/definitions/TrackingSummary"
}
},
"description": "The payload for the getTracking operation."
},
"SubmitNdrFeedbackRequest": {
"type": "object",
"description": "The request schema for the NdrFeedback operation",
"required": [
"trackingId",
"ndrAction"
],
"properties": {
"trackingId": {
"$ref": "#/definitions/TrackingId"
},
"ndrAction": {
"$ref": "#/definitions/NdrAction"
},
"ndrRequestData": {
"$ref": "#/definitions/NdrRequestData"
}
}
},
"GetTrackingResponse": {
"type": "object",
"properties": {
"payload": {
"$ref": "#/definitions/GetTrackingResult"
}
},
"description": "The response schema for the getTracking operation."
},
"PurchaseShipmentRequest": {
"description": "The request schema for the purchaseShipment operation.",
"type": "object",
"required": [
"rateId",
"requestedDocumentSpecification",
"requestToken"
],
"properties": {
"requestToken": {
"$ref": "#/definitions/RequestToken"
},
"rateId": {
"$ref": "#/definitions/RateId"
},
"requestedDocumentSpecification": {
"$ref": "#/definitions/RequestedDocumentSpecification"
},
"requestedValueAddedServices": {
"$ref": "#/definitions/RequestedValueAddedServiceList"
},
"additionalInputs": {
"type": "object",
"additionalProperties" : {},
"description": "The additional inputs required to purchase a shipping offering, in JSON format. The JSON provided here must adhere to the JSON schema that is returned in the response to the getAdditionalInputs operation.\n\nAdditional inputs are only required when indicated by the requiresAdditionalInputs property in the response to the getRates operation."
}
}
},
"PurchaseShipmentResult": {
"type": "object",
"required": [
"packageDocumentDetails",
"promise",
"shipmentId"
],
"properties": {
"shipmentId": {
"$ref": "#/definitions/ShipmentId"
},
"packageDocumentDetails": {
"$ref": "#/definitions/PackageDocumentDetailList"
},
"promise": {
"$ref": "#/definitions/Promise"
}
},
"description": "The payload for the purchaseShipment operation."
},
"PurchaseShipmentResponse": {
"type": "object",
"properties": {
"payload": {
"$ref": "#/definitions/PurchaseShipmentResult"
}
},
"description": "The response schema for the purchaseShipment operation."
},
"OneClickShipmentRequest": {
"description": "The request schema for the OneClickShipment operation. When the channelType is not Amazon, shipTo is required and when channelType is Amazon shipTo is ignored.",
"type": "object",
"required": [
"channelDetails",
"packages",
"shipFrom",
"labelSpecifications",
"serviceSelection"
],
"properties": {
"shipTo": {
"description": "The ship to address.",
"$ref": "#/definitions/Address"
},
"shipFrom": {
"description": "The ship from address.",
"$ref": "#/definitions/Address"
},
"returnTo": {
"description": "The return to address.",
"$ref": "#/definitions/Address"
},
"shipDate": {
"type": "string",
"format": "date-time",
"description": "The ship date and time (the requested pickup). This defaults to the current date and time."
},
"packages": {
"$ref": "#/definitions/PackageList"
},
"valueAddedServicesDetails": {
"$ref": "#/definitions/OneClickShipmentValueAddedServiceDetails"
},
"taxDetails": {
"$ref": "#/definitions/TaxDetailList"
},
"channelDetails": {
"$ref": "#/definitions/ChannelDetails"
},
"labelSpecifications" : {
"$ref": "#/definitions/RequestedDocumentSpecification"
},
"serviceSelection": {
"$ref": "#/definitions/ServiceSelection"
},
"shipperInstruction": {
"$ref": "#/definitions/ShipperInstruction",
"description": "Optional field for shipper instruction."
},
"destinationAccessPointDetails": {
"$ref": "#/definitions/AccessPointDetails"
}
}
},
"OneClickShipmentResponse": {
"type": "object",
"properties": {
"payload": {
"$ref": "#/definitions/OneClickShipmentResult"
}
},
"description": "The response schema for the OneClickShipment operation."
},
"OneClickShipmentResult": {
"type": "object",
"required": [
"packageDocumentDetails",
"promise",
"shipmentId",
"service",
"carrier",
"totalCharge"
],
"properties": {
"shipmentId": {
"$ref": "#/definitions/ShipmentId"
},
"packageDocumentDetails": {
"$ref": "#/definitions/PackageDocumentDetailList"
},
"promise": {
"$ref": "#/definitions/Promise"
},
"carrier": {
"$ref": "#/definitions/Carrier"
},
"service": {
"$ref": "#/definitions/Service"
},
"totalCharge": {
"$ref": "#/definitions/Currency"
}
},
"description": "The payload for the OneClickShipment API."
},
"GetAccessPointsResponse": {
"type": "object",
"properties": {
"payload": {
"$ref": "#/definitions/GetAccessPointsResult"
}
},
"description": "The response schema for the GetAccessPoints operation."
},
"GetAccessPointsResult": {
"type": "object",
"required": [
"accessPointsMap"
],
"properties": {
"accessPointsMap": {
"$ref": "#/definitions/AccessPointsMap"
}
},
"description": "The payload for the GetAccessPoints API."
},
"AccessPointType": {
"description": "The type of access point, like counter (HELIX), lockers, etc.",
"type": "string",
"enum": [
"HELIX",
"CAMPUS_LOCKER",
"OMNI_LOCKER",
"ODIN_LOCKER",
"DOBBY_LOCKER",
"CORE_LOCKER",
"3P",
"CAMPUS_ROOM"
],
"x-docgen-enum-table-extension": [
{
"value": "HELIX",
"description": "Counter, aka Helix, is an assisted access point where customers interact with a store associate to collect or return packages. Counter stores do not have Locker"
},
{
"value": "CAMPUS_LOCKER",
"description": "It denotes a physical Locker present at Locker+ stores"
},
{
"value": "OMNI_LOCKER",
"description": "Omni lockers are similar to core lockers installed at apartment buildings. Core and Omni will have common base hardware platform"
},
{
"value": "ODIN_LOCKER",
"description": "Odin lockers rely on Bluetooth connection as there is no screen or scanner on the locker. Drivers, customers, and even technicians can interact with the locker using an app (different depending on the user)."
},
{
"value": "DOBBY_LOCKER",
"description": "Dobby lockers are Odin lockers installed at apartment complexes and available only to residents."
},
{
"value": "CORE_LOCKER",
"description": "Core lockers are the traditional and initial style of lockers when Hub was launched. Core lockers have a screen, keypad and scanner. Customer either enter their pickup code using the Locker screen or scan pickup code barcode to pick up their package."
},
{
"value": "3P",
"description": "Networks that are owned end-to-end by commercial carriers (CC - e.g. DHL, UPS, DPD and Postal organizations), who operate both the transportation leg and the access point aspect. These networks offer a range of pickup points including: 3P Lockers, legacy Postal Offices, 3P Counters (e.g. Gas Stations and Retail Outlets - supermarkets, bookstores, news-stands etc)."
},
{
"value": "CAMPUS_ROOM",
"description": "Locker+, formerly known as Campus, are attended, physical stores, where the Locker is used dynamically by the staff to keep packages ready for customer pickup. Locker+ store can have multiple Lockers installed,"
}
]
},
"AccessPointsMap": {
"description": "Map of type of access point to list of access points",
"type": "object",
"additionalProperties": {
"$ref": "#/definitions/AccessPointList"
}
},
"AccessPointList": {
"description": "List of relevant Access points requested by shipper. These access points are sorted by proximity to postal code, and are limited to 40. We have internally defined a radius value to render relevant results.",
"type": "array",
"items": {
"$ref": "#/definitions/AccessPoint"
}
},
"AccessPointId": {
"description": "Unique identifier for the access point",
"type": "string"
},
"AccessPoint": {
"type": "object",
"description": "Access point details",
"properties": {
"accessPointId": {
"$ref": "#/definitions/AccessPointId"
},
"name": {
"description": "Name of entity (store/hub etc) where this access point is located",
"type": "string"
},
"timezone": {
"description": "Timezone of access point",
"type": "string"
},
"type": {
"$ref": "#/definitions/AccessPointType"
},
"accessibilityAttributes": {
"$ref": "#/definitions/AccessibilityAttributes"
},
"address": {
"$ref": "#/definitions/Address"
},
"exceptionOperatingHours": {
"type": "array",
"items": {
"$ref": "#/definitions/ExceptionOperatingHours"
}
},
"assistanceType": {
"type": "string",
"enum": [
"STAFF_ASSISTED",
"SELF_ASSISTED"
]
},
"score": {
"type": "string",
"description": "The score of access point, based on proximity to postal code and sorting preference. This can be used to sort access point results on shipper's end."
},
"standardOperatingHours": {
"$ref": "#/definitions/DayOfWeekTimeMap"
}
}
},
"AccessibilityAttributes": {
"type": "object",
"description": "Defines the accessibility details of the access point.",
"properties": {
"distance": {
"description": "The approximate distance of access point from input postalCode's centroid.",
"type": "string"
},
"driveTime": {
"description": "The approximate (static) drive time from input postal code's centroid.",
"type": "integer"
}
}
},
"OperatingHours": {
"type": "object",
"description": "The hours in which the access point shall remain operational",
"properties": {
"closingTime": {
"$ref": "#/definitions/TimeOfDay"
},
"openingTime": {
"$ref": "#/definitions/TimeOfDay"
},
"midDayClosures": {
"type": "array",
"items": {
"$ref": "#/definitions/TimeOfDay"
}
}
}
},
"TimeOfDay": {
"type": "object",
"description": "Denotes time of the day, used for defining opening or closing time of access points",
"properties": {
"hourOfDay": {
"type": "integer"
},
"minuteOfHour": {
"type": "integer"
},
"secondOfMinute": {
"type": "integer"
}
}
},
"DayOfWeekTimeMap": {
"description": "Map of day of the week to operating hours of that day",
"type": "object",
"additionalProperties": {
"$ref": "#/definitions/OperatingHours"
}
},
"ExceptionOperatingHours": {
"type": "object",
"description": "Defines exceptions to standard operating hours for certain date ranges.",
"properties": {
"dateRange": {
"$ref": "#/definitions/DateRange"
},
"operatingHours": {
"$ref": "#/definitions/OperatingHours"
}
}
},
"ClientReferenceDetails": {
"type": "array",
"description": "Object to pass additional information about the MCI Integrator shipperType: List of ClientReferenceDetail",
"items": {
"$ref": "#/definitions/ClientReferenceDetail"
}
},
"ClientReferenceDetail": {
"type": "object",
"required": [
"clientReferenceType",
"clientReferenceId"
],
"properties": {
"clientReferenceType": {
"type": "string",
"description": "Client Reference type.",
"enum": [
"IntegratorShipperId",
"IntegratorMerchantId"
],
"x-docgen-enum-table-extension": [
{
"value": "IntegratorShipperId",
"description": "The unique identifier assigned to a 3P seller by the shipping integrator."
},
{
"value": "IntegratorMerchantId",
"description": "The unique identifier assigned to a 3P shipping integrator by Amazon."
}
]
},
"clientReferenceId": {
"type": "string",
"description": "The Client Reference Id."
}
},
"description": "Client Reference Details"
},
"ShipmentType": {
"type": "string",
"description": "Shipment type.",
"enum": [
"FORWARD",
"RETURNS"
],
"x-docgen-enum-table-extension": [
{
"value": "FORWARD",
"description": "Additional information about shipment representing package journey from origin address to destination address in the transportation/shipping request."
},
{
"value": "RETURNS",
"description": "Additional information about shipment representing package journey from destination address to origin/return address in the original transportation/shipping request."
}
]
},
"DateRange": {
"type": "object",
"properties": {
"startDate": {
"type": "string",
"format": "dateTime",
"description": "Start Date for query ."
},
"endDate": {
"type": "string",
"format": "dateTime",
"description": "end date for query."
}
},
"description": "Date Range for query the results."
},
"PaymentType": {
"type": "string",
"description": "Payment type of the purchase.",
"enum": [
"PAY_THROUGH_AMAZON",
"PAY_DIRECT_TO_CARRIER"
],
"x-docgen-enum-table-extension": [
{
"value": "PAY_THROUGH_AMAZON",
"description": "Payment Through Amazon."
},
{
"value": "PAY_DIRECT_TO_CARRIER",
"description": "Payment Direct to Carrier."
}
]
},
"RateItemList": {
"type": "array",
"description": "A list of RateItem",
"items": {
"$ref": "#/definitions/RateItem"
}
},
"RateItem": {
"type": "object",
"properties": {
"rateItemID": {
"$ref": "#/definitions/RateItemID"
},
"rateItemType": {
"$ref": "#/definitions/RateItemType"
},
"rateItemCharge": {
"$ref": "#/definitions/Currency"
},
"rateItemNameLocalization": {
"type": "string",
"description": "Used for the localization."
}
},
"description": "Rate Item for shipping (base cost, transaction fee, confirmation, insurance, etc.) Data source definition: "
},
"RateItemID": {
"type": "string",
"description": "Unique ID for the rateItem.",
"enum": [
"BASE_RATE",
"TRANSACTION_FEE",
"ADULT_SIGNATURE_CONFIRMATION",
"SIGNATURE_CONFIRMATION",
"NO_CONFIRMATION",
"WAIVE_SIGNATURE",
"IMPLIED_LIABILITY",
"HIDDEN_POSTAGE",
"DECLARED_VALUE",
"SUNDAY_HOLIDAY_DELIVERY",
"DELIVERY_CONFIRMATION",
"IMPORT_DUTY_CHARGE",
"VAT",
"NO_SATURDAY_DELIVERY",
"INSURANCE",
"COD",
"FUEL_SURCHARGE",
"INSPECTION_CHARGE",
"DELIVERY_AREA_SURCHARGE",
"WAYBILL_CHARGE",
"AMAZON_SPONSORED_DISCOUNT",
"INTEGRATOR_SPONSORED_DISCOUNT",
"OVERSIZE_SURCHARGE",
"CONGESTION_CHARGE",
"RESIDENTIAL_SURCHARGE",
"ADDITIONAL_SURCHARGE",
"SURCHARGE",
"REBATE"
],
"x-docgen-enum-table-extension": [
{
"value": "BASE_RATE",
"description": "for Base Rate."
},
{
"value": "TRANSACTION_FEE",
"description": "Charge for TransAction Fee."
},
{
"value": "ADULT_SIGNATURE_CONFIRMATION",
"description": "Charge for Adult Signature Confirmation."
},
{
"value": "SIGNATURE_CONFIRMATION",
"description": "Charge for signature confirmation."
},
{
"value": "NO_CONFIRMATION",
"description": "Charge for No Confirmation."
},
{
"value": "WAIVE_SIGNATURE",
"description": "Charge for Waive Signature."
},
{
"value": "IMPLIED_LIABILITY",
"description": "Charge for Implied Liability."
},
{
"value": "HIDDEN_POSTAGE",
"description": "Hidden Postage Charge."
},
{
"value": "DECLARED_VALUE",
"description": "Declared Valure Coverage Charge."
},
{
"value": "SUNDAY_HOLIDAY_DELIVERY",
"description": "Sunday Holiday Delivery Charge."
},
{
"value": "DELIVERY_CONFIRMATION",
"description": "Charge for Delivery Confirmation."
},
{
"value": "IMPORT_DUTY_CHARGE",
"description": "Import Duty Charge."
},
{
"value": "VAT",
"description": "Vat Charge."
},
{
"value": "NO_SATURDAY_DELIVERY",
"description": "Charge for No Satuarday Delivery."
},
{
"value": "INSURANCE",
"description": "Insurance Charge."
},
{
"value": "COD",
"description": "COD Charge."
},
{
"value": "AMAZON_SPONSORED_DISCOUNT",
"description": "Amazon Sponsored Discount."
},
{
"value": "INTEGRATOR_SPONSORED_DISCOUNT",
"description": "Integrator Sponsored Discount."
},
{
"value": "FUEL_SURCHARGE",
"description": "Fuel Surcharge."
},
{
"value": "INSPECTION_CHARGE",
"description": "Inspection Charge."
},
{
"value": "DELIVERY_AREA_SURCHARGE",
"description": "Delivery Area Surcharge."
},
{
"value": "WAYBILL_CHARGE",
"description": "WayBill Charge."
},
{
"value": "OVERSIZE_SURCHARGE",
"description": "OverSize Surcharge."
},
{
"value": "CONGESTION_CHARGE",
"description": "Congestion Charge."
},
{
"value": "RESIDENTIAL_SURCHARGE",
"description": "Residential Surcharge."
},
{
"value": "ADDITIONAL_SURCHARGE",
"description": "Additional Surcharge."
},
{
"value": "SURCHARGE",
"description": "Surcharge."
},
{
"value": "REBATE",
"description": "Rebate."
}
]
},
"RateItemType": {
"type": "string",
"description": "Type of the rateItem.",
"enum": [
"MANDATORY",
"OPTIONAL",
"INCLUDED"
],
"x-docgen-enum-table-extension": [
{
"value": "MANDATORY",
"description": "Rate Item is mandatory."
},
{
"value": "OPTIONAL",
"description": "Rate Item is Optional."
},
{
"value": "INCLUDED",
"description": "Rate Item is included."
}
]
},
"Benefits": {
"type": "object",
"description": "Representing the included/excluded benefits that we offer for each ShippingOffering/Rate. Benefits being services provided by Amazon when sellers purchase shipping through Amazon.",
"required": [
"includedBenefits",
"excludedBenefits"
],
"properties": {
"includedBenefits": {
"$ref": "#/definitions/IncludedBenefits"
},
"excludedBenefits": {
"$ref": "#/definitions/ExcludedBenefits"
}
}
},
"IncludedBenefits": {
"type": "array",
"description": "A list of included benefits.",
"items": {
"type": "string"
}
},
"ExcludedBenefits": {
"type": "array",
"description": "A list of excluded benefit. Refer to the ExcludeBenefit object for further documentation",
"items": {
"$ref": "#/definitions/ExcludedBenefit"
}
},
"ExcludedBenefit": {
"type": "object",
"description": "Object representing an excluded benefit that is excluded for an ShippingOffering/Rate.",
"required": [
"benefit",
"reasonCode"
],
"properties": {
"benefit": {
"type": "string"
},
"reasonCode": {
"type": "string"
}
}
},
"ServiceSelection" : {
"description": "Service Selection Criteria.",
"type": "object",
"required": ["serviceId"],
"properties": {
"serviceId": {
"$ref": "#/definitions/ServiceIds"
}
}
},
"ServiceIds": {
"type": "array",
"description": "A list of ServiceId.",
"items": {
"type": "string"
}
},
"OneClickShipmentValueAddedServiceDetails": {
"type": "array",
"description": "The value-added services to be added to a shipping service purchase.",
"items": {
"$ref": "#/definitions/OneClickShipmentValueAddedService"
}
},
"OneClickShipmentValueAddedService": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The identifier of the selected value-added service."
},
"amount": {
"$ref": "#/definitions/Currency"
}
},
"description": "A value-added service to be applied to a shipping service purchase."
},
"Service" : {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"$ref": "#/definitions/ServiceId"
},
"name": {
"$ref": "#/definitions/ServiceName"
}
},
"description": "Service Related Info"
},
"Carrier" : {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"$ref": "#/definitions/CarrierId"
},
"name": {
"$ref": "#/definitions/CarrierName"
}
},
"description": "Carrier Related Info"
}
}
}
Updated 12 days ago