{ "openapi": "3.0.1", "info": { "title": "Selling Partner API for Shipping", "description": "Provides programmatic access to Amazon Shipping APIs.\n\n **Note:** If you are new to the Amazon Shipping API, refer to the latest version of Amazon Shipping API (v2) on the Amazon Shipping Developer Documentation site.", "contact": { "name": "Selling Partner API Developer Support", "url": "https://sellercentral.amazon.com/gp/mws/contactus.html" }, "license": { "name": "Apache License 2.0", "url": "http://www.apache.org/licenses/LICENSE-2.0" }, "version": "v1" }, "servers": [ { "url": "https://sellingpartnerapi-na.amazon.com/" } ], "paths": { "/shipping/v1/shipments": { "post": { "tags": [ "shipping" ], "description": "Create a new shipment.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 5 | 15 |\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 than 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": "createShipment", "requestBody": { "description": "CreateShipmentRequest Body", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateShipmentRequest" } } }, "required": true }, "responses": { "200": { "description": "Success.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateShipmentResponse" }, "example": { "shipmentId": "89108749065090", "eligibleRates": [ { "billedWeight": { "value": 4, "unit": "kg" }, "totalCharge": { "value": 3.25, "unit": "GBP" }, "serviceType": "Amazon Shipping Standard", "promise": { "deliveryWindow": { "start": "2018-08-25T20:22:30.737Z", "end": "2018-08-26T20:22:30.737Z" }, "receiveWindow": { "start": "2018-08-23T09:22:30.737Z", "end": "2018-08-23T11:22:30.737Z" } }, "rateId": "RI123456", "expirationTime": "2018-08-22T09:22:30.737Z" } ] } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "body": { "value": { "clientReferenceId": "TEST_CASE_200" } } } }, "response": { "payload": { "shipmentId": "TEST_CASE_200", "eligibleRates": [ { "billedWeight": { "value": 4, "unit": "kg" }, "totalCharge": { "value": 3.25, "unit": "GBP" }, "serviceType": "Amazon Shipping Standard", "promise": { "deliveryWindow": { "start": "2018-08-25T20:22:30.737Z", "end": "2018-08-26T20:22:30.737Z" }, "receiveWindow": { "start": "2018-08-23T09:22:30.737Z", "end": "2018-08-23T11:22:30.737Z" } }, "rateId": "RI123456", "expirationTime": "2018-08-22T09:22:30.737Z" } ] } } } ] } }, "400": { "description": "Request has missing or invalid parameters and cannot be parsed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateShipmentResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "body": { "value": { "clientReferenceId": "TEST_CASE_400" } } } }, "response": { "errors": [ { "code": "InvalidInput", "message": "Invalid input." } ] } } ] } }, "401": { "description": "The request's Authorization header is not formatted correctly or does not contain a valid token.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateShipmentResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "body": { "value": { "clientReferenceId": "TEST_CASE_401" } } } }, "response": { "errors": [ { "code": "Unauthorized", "message": "Access to requested resource is denied." } ] } } ] } }, "403": { "description": "403 can be caused for reasons like Access Denied, Unauthorized, Expired Token, Invalid Signature or Resource Not Found.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateShipmentResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "body": { "value": { "clientReferenceId": "TEST_CASE_403" } } } }, "response": { "errors": [ { "code": "Unauthorized", "message": "Access to requested resource is denied." } ] } } ] } }, "404": { "description": "The resource specified does not exist.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateShipmentResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "body": { "value": { "clientReferenceId": "TEST_CASE_404" } } } }, "response": { "errors": [ { "code": "NotFound", "message": "The requested resource doesn't exist." } ] } } ] } }, "429": { "description": "The frequency of requests was greater than allowed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateShipmentResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "body": { "value": { "clientReferenceId": "TEST_CASE_429" } } } }, "response": { "errors": [ { "code": "QuotaExceeded", "message": "You exceeded your quota for the requested resource." } ] } } ] } }, "500": { "description": "Encountered an unexpected condition which prevented the server from fulfilling the request.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateShipmentResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "body": { "value": { "clientReferenceId": "TEST_CASE_500" } } } }, "response": { "errors": [ { "code": "InternalFailure", "message": "We encountered an internal error. Please try again." } ] } } ] } }, "503": { "description": "Temporary overloading or maintenance of the server.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateShipmentResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "body": { "value": { "clientReferenceId": "TEST_CASE_503" } } } }, "response": { "errors": [ { "code": "ServiceUnavailable", "message": "Service is temporarily unavailable. Please try again." } ] } } ] } } }, "x-codegen-request-body-name": "body" } }, "/shipping/v1/shipments/{shipmentId}": { "get": { "tags": [ "shipping" ], "description": "Return the entire shipment object for the shipmentId.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 5 | 15 |\n\nFor more information, see \"Usage Plans and Rate Limits\" in the Selling Partner API documentation.", "operationId": "getShipment", "parameters": [ { "name": "shipmentId", "in": "path", "description": "Shipment id to return the entire shipment object", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetShipmentResponse" }, "example": { "shipmentId": "89108749065090", "clientReferenceId": "911-7267646-6348616", "shipFrom": {}, "shipTo": {}, "acceptedRate": { "billedWeight": { "value": 4, "unit": "kg" }, "totalCharge": { "value": 3.5, "unit": "GBP" }, "serviceType": "Amazon Shipping Standard", "promise": { "deliveryWindow": { "start": "2018-08-25T20:22:30.737Z", "end": "2018-08-26T20:22:30.737Z" }, "receiveWindow": { "start": "2018-08-23T09:22:30.737Z", "end": "2018-08-23T11:22:30.737Z" } } }, "shipper": { "accountId": "2755049166" }, "containers": [ { "containerReferenceId": "CRI123456789", "items": [ { "title": "String", "unitWeight": { "value": 0.08164656, "unit": "kg" }, "quantity": 2, "unitPrice": { "value": 14.99, "unit": "GBP" } } ], "dimensions": { "height": 12, "length": 36, "width": 31, "unit": "CM" }, "containerType": "PACKAGE", "weight": { "unit": "kg", "value": 4 }, "value": { "value": 29.98, "unit": "GBP" } } ] } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_200" } } }, "response": { "payload": { "shipmentId": "TEST_CASE_200", "clientReferenceId": "911-7267646-6348616", "shipFrom": {}, "shipTo": {}, "acceptedRate": { "billedWeight": { "value": 4, "unit": "kg" }, "totalCharge": { "value": 3.5, "unit": "GBP" }, "serviceType": "Amazon Shipping Standard", "promise": { "deliveryWindow": { "start": "2018-08-25T20:22:30.737Z", "end": "2018-08-26T20:22:30.737Z" }, "receiveWindow": { "start": "2018-08-23T09:22:30.737Z", "end": "2018-08-23T11:22:30.737Z" } } }, "shipper": { "accountId": "2755049166" }, "containers": [ { "containerReferenceId": "CRI123456789", "items": [ { "title": "String", "unitWeight": { "value": 0.08164656, "unit": "kg" }, "quantity": 2, "unitPrice": { "value": 14.99, "unit": "GBP" } } ], "dimensions": { "height": 12, "length": 36, "width": 31, "unit": "CM" }, "containerType": "PACKAGE", "weight": { "unit": "kg", "value": 4 }, "value": { "value": 29.98, "unit": "GBP" } } ] } } } ] } }, "400": { "description": "Request has missing or invalid parameters and cannot be parsed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetShipmentResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_400" } } }, "response": { "errors": [ { "code": "InvalidInput", "message": "Invalid input." } ] } } ] } }, "401": { "description": "The request's Authorization header is not formatted correctly or does not contain a valid token.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetShipmentResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_401" } } }, "response": { "errors": [ { "code": "Unauthorized", "message": "Access to requested resource is denied." } ] } } ] } }, "403": { "description": "403 can be caused for reasons like Access Denied, Unauthorized, Expired Token, Invalid Signature or Resource Not Found.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetShipmentResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_403" } } }, "response": { "errors": [ { "code": "Unauthorized", "message": "Access to requested resource is denied." } ] } } ] } }, "404": { "description": "The resource specified does not exist.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetShipmentResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_404" } } }, "response": { "errors": [ { "code": "NotFound", "message": "The requested resource doesn't exist." } ] } } ] } }, "429": { "description": "The frequency of requests was greater than allowed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetShipmentResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_429" } } }, "response": { "errors": [ { "code": "QuotaExceeded", "message": "You exceeded your quota for the requested resource." } ] } } ] } }, "500": { "description": "Encountered an unexpected condition which prevented the server from fulfilling the request.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetShipmentResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_500" } } }, "response": { "errors": [ { "code": "InternalFailure", "message": "We encountered an internal error. Please try again." } ] } } ] } }, "503": { "description": "Temporary overloading or maintenance of the server.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetShipmentResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_503" } } }, "response": { "errors": [ { "code": "ServiceUnavailable", "message": "Service is temporarily unavailable. Please try again." } ] } } ] } } } } }, "/shipping/v1/shipments/{shipmentId}/cancel": { "post": { "tags": [ "shipping" ], "description": "Cancel a shipment by the given shipmentId.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 5 | 15 |\n\nFor more information, see \"Usage Plans and Rate Limits\" in the Selling Partner API documentation.", "operationId": "cancelShipment", "parameters": [ { "name": "shipmentId", "in": "path", "description": "Shipment Id to cancel a shipment", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelShipmentResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_200" } } }, "response": {} } ] } }, "400": { "description": "Request has missing or invalid parameters and cannot be parsed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelShipmentResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_400" } } }, "response": { "errors": [ { "code": "InvalidInput", "message": "Invalid input." } ] } } ] } }, "401": { "description": "The request's Authorization header is not formatted correctly or does not contain a valid token.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelShipmentResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_401" } } }, "response": { "errors": [ { "code": "Unauthorized", "message": "Access to requested resource is denied." } ] } } ] } }, "403": { "description": "403 can be caused for reasons like Access Denied, Unauthorized, Expired Token, Invalid Signature or Resource Not Found.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelShipmentResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_403" } } }, "response": { "errors": [ { "code": "Unauthorized", "message": "Access to requested resource is denied." } ] } } ] } }, "404": { "description": "The resource specified does not exist.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelShipmentResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_404" } } }, "response": { "errors": [ { "code": "NotFound", "message": "The requested resource doesn't exist." } ] } } ] } }, "429": { "description": "The frequency of requests was greater than allowed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelShipmentResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_429" } } }, "response": { "errors": [ { "code": "QuotaExceeded", "message": "You exceeded your quota for the requested resource." } ] } } ] } }, "500": { "description": "Encountered an unexpected condition which prevented the server from fulfilling the request.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelShipmentResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_500" } } }, "response": { "errors": [ { "code": "InternalFailure", "message": "We encountered an internal error. Please try again." } ] } } ] } }, "503": { "description": "Temporary overloading or maintenance of the server.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelShipmentResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_503" } } }, "response": { "errors": [ { "code": "ServiceUnavailable", "message": "Service is temporarily unavailable. Please try again." } ] } } ] } } } } }, "/shipping/v1/shipments/{shipmentId}/purchaseLabels": { "post": { "tags": [ "shipping" ], "description": "Purchase shipping labels based on a given rate.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 5 | 15 |\n\nFor more information, see \"Usage Plans and Rate Limits\" in the Selling Partner API documentation.", "operationId": "purchaseLabels", "parameters": [ { "name": "shipmentId", "in": "path", "description": "Shipment id for purchase shipping label", "required": true, "schema": { "type": "string" } } ], "requestBody": { "description": "PurchaseShippingLabelRequest body", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PurchaseLabelsRequest" } } }, "required": true }, "responses": { "200": { "description": "Success.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PurchaseLabelsResponse" }, "example": { "shipmentId": "89108749065090", "clientReferenceId": "911-7267646-6348616", "acceptedRate": { "billedWeight": { "value": 4, "unit": "kg" }, "totalCharge": { "value": 3.5, "unit": "GBP" }, "serviceType": "Amazon Shipping Standard", "promise": { "deliveryWindow": { "start": "2018-08-25T20:22:30.737Z", "end": "2018-08-26T20:22:30.737Z" }, "receiveWindow": { "start": "2018-08-23T09:22:30.737Z", "end": "2018-08-23T11:22:30.737Z" } } }, "labelResults": [ { "containerReferenceId": "CRI123456789", "trackingId": "1512748795322", "label": { "labelStream": "iVBORw0KGgo...AAAARK5CYII=(Truncated)", "labelSpecification": { "labelFormat": "PNG", "labelStockSize": "4x6" } } } ] } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_200" } } }, "response": { "payload": { "shipmentId": "TEST_CASE_200", "clientReferenceId": "911-7267646-6348616", "acceptedRate": { "billedWeight": { "value": 4, "unit": "kg" }, "totalCharge": { "value": 3.5, "unit": "GBP" }, "serviceType": "Amazon Shipping Standard", "promise": { "deliveryWindow": { "start": "2018-08-25T20:22:30.737Z", "end": "2018-08-26T20:22:30.737Z" }, "receiveWindow": { "start": "2018-08-23T09:22:30.737Z", "end": "2018-08-23T11:22:30.737Z" } } }, "labelResults": [ { "containerReferenceId": "CRI123456789", "trackingId": "1512748795322", "label": { "labelStream": "iVBORw0KGgo...AAAARK5CYII=(Truncated)", "labelSpecification": { "labelFormat": "PNG", "labelStockSize": "4x6" } } } ] } } } ] } }, "400": { "description": "Request has missing or invalid parameters and cannot be parsed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PurchaseLabelsResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_400" } } }, "response": { "errors": [ { "code": "InvalidInput", "message": "Invalid input." } ] } } ] } }, "401": { "description": "The request's Authorization header is not formatted correctly or does not contain a valid token.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PurchaseLabelsResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_401" } } }, "response": { "errors": [ { "code": "Unauthorized", "message": "Access to requested resource is denied." } ] } } ] } }, "403": { "description": "403 can be caused for reasons like Access Denied, Unauthorized, Expired Token, Invalid Signature or Resource Not Found.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PurchaseLabelsResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_403" } } }, "response": { "errors": [ { "code": "Unauthorized", "message": "Access to requested resource is denied." } ] } } ] } }, "404": { "description": "The resource specified does not exist.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PurchaseLabelsResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_404" } } }, "response": { "errors": [ { "code": "NotFound", "message": "The requested resource doesn't exist." } ] } } ] } }, "429": { "description": "The frequency of requests was greater than allowed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PurchaseLabelsResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_429" } } }, "response": { "errors": [ { "code": "QuotaExceeded", "message": "You exceeded your quota for the requested resource." } ] } } ] } }, "500": { "description": "Encountered an unexpected condition which prevented the server from fulfilling the request.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PurchaseLabelsResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_500" } } }, "response": { "errors": [ { "code": "InternalFailure", "message": "We encountered an internal error. Please try again." } ] } } ] } }, "503": { "description": "Temporary overloading or maintenance of the server.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PurchaseLabelsResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_503" } } }, "response": { "errors": [ { "code": "ServiceUnavailable", "message": "Service is temporarily unavailable. Please try again." } ] } } ] } } }, "x-codegen-request-body-name": "body" } }, "/shipping/v1/shipments/{shipmentId}/containers/{trackingId}/label": { "post": { "tags": [ "shipping" ], "description": "Retrieve shipping label based on the shipment id and tracking id.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 5 | 15 |\n\nFor more information, see \"Usage Plans and Rate Limits\" in the Selling Partner API documentation.", "operationId": "retrieveShippingLabel", "parameters": [ { "name": "shipmentId", "in": "path", "description": "Shipment Id to retreive label", "required": true, "schema": { "type": "string" } }, { "name": "trackingId", "in": "path", "description": "Tracking Id", "required": true, "schema": { "type": "string" } } ], "requestBody": { "description": "RetrieveShippingLabelRequest body", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveShippingLabelRequest" } } }, "required": true }, "responses": { "200": { "description": "Success.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveShippingLabelResponse" }, "example": { "labelStream": "iVBORw0KGgo...AAAARK5CYII=(Truncated)", "labelSpecification": { "labelFormat": "PNG", "labelStockSize": "4x6" } } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_200" } } }, "response": { "payload": { "labelStream": "iVBORw0KGgo...AAAARK5CYII=(Truncated)", "labelSpecification": { "labelFormat": "PNG", "labelStockSize": "4x6" } } } } ] } }, "400": { "description": "Request has missing or invalid parameters and cannot be parsed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveShippingLabelResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_400" } } }, "response": { "errors": [ { "code": "InvalidInput", "message": "Invalid input." } ] } } ] } }, "401": { "description": "The request's Authorization header is not formatted correctly or does not contain a valid token.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveShippingLabelResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_401" } } }, "response": { "errors": [ { "code": "Unauthorized", "message": "Access to requested resource is denied." } ] } } ] } }, "403": { "description": "403 can be caused for reasons like Access Denied, Unauthorized, Expired Token, Invalid Signature or Resource Not Found.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveShippingLabelResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_403" } } }, "response": { "errors": [ { "code": "Unauthorized", "message": "Access to requested resource is denied." } ] } } ] } }, "404": { "description": "The resource specified does not exist.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveShippingLabelResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_404" } } }, "response": { "errors": [ { "code": "NotFound", "message": "The requested resource doesn't exist." } ] } } ] } }, "429": { "description": "The frequency of requests was greater than allowed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveShippingLabelResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_429" } } }, "response": { "errors": [ { "code": "QuotaExceeded", "message": "You exceeded your quota for the requested resource." } ] } } ] } }, "500": { "description": "Encountered an unexpected condition which prevented the server from fulfilling the request.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveShippingLabelResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_500" } } }, "response": { "errors": [ { "code": "InternalFailure", "message": "We encountered an internal error. Please try again." } ] } } ] } }, "503": { "description": "Temporary overloading or maintenance of the server.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveShippingLabelResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "shipmentId": { "value": "TEST_CASE_503" } } }, "response": { "errors": [ { "code": "ServiceUnavailable", "message": "Service is temporarily unavailable. Please try again." } ] } } ] } } }, "x-codegen-request-body-name": "body" } }, "/shipping/v1/purchaseShipment": { "post": { "tags": [ "shipping" ], "description": "Purchase shipping labels.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 5 | 15 |\n\nFor more information, see \"Usage Plans and Rate Limits\" in the Selling Partner API documentation.", "operationId": "purchaseShipment", "requestBody": { "description": "PurchaseShipmentRequest body", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PurchaseShipmentRequest" } } }, "required": true }, "responses": { "200": { "description": "Success.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PurchaseShipmentResponse" }, "example": { "shipmentId": "89108749065090", "serviceRate": { "billableWeight": { "value": 4, "unit": "kg" }, "totalCharge": { "value": 3.5, "unit": "GBP" }, "serviceType": "Amazon Shipping Standard", "promise": { "deliveryWindow": { "start": "2018-08-25T20:22:30.737Z", "end": "2018-08-26T20:22:30.737Z" }, "receiveWindow": { "start": "2018-08-23T09:22:30.737Z", "end": "2018-08-23T11:22:30.737Z" } } }, "labelResults": [ { "containerReferenceId": "CRI123456789", "trackingId": "1512748795322", "label": { "labelStream": "iVBORw0KGgo...AAAARK5CYII=(Truncated)", "labelSpecification": { "labelFormat": "PNG", "labelStockSize": "4x6" } } } ] } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "body": { "value": { "clientReferenceId": "TEST_CASE_2000" } } } }, "response": { "payload": { "shipmentId": "TEST_CASE_200", "serviceRate": { "billableWeight": { "value": 4, "unit": "kg" }, "totalCharge": { "value": 3.5, "unit": "GBP" }, "serviceType": "Amazon Shipping Standard", "promise": { "deliveryWindow": { "start": "2018-08-25T20:22:30.737Z", "end": "2018-08-26T20:22:30.737Z" }, "receiveWindow": { "start": "2018-08-23T09:22:30.737Z", "end": "2018-08-23T11:22:30.737Z" } } }, "labelResults": [ { "containerReferenceId": "CRI123456789", "trackingId": "1512748795322", "label": { "labelStream": "iVBORw0KGgo...AAAARK5CYII=(Truncated)", "labelSpecification": { "labelFormat": "PNG", "labelStockSize": "4x6" } } } ] } } } ] } }, "400": { "description": "Request has missing or invalid parameters and cannot be parsed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PurchaseShipmentResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "body": { "value": { "clientReferenceId": "TEST_CASE_200" } } } }, "response": { "errors": [ { "code": "InvalidInput", "message": "Invalid input." } ] } } ] } }, "401": { "description": "The request's Authorization header is not formatted correctly or does not contain a valid token.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PurchaseShipmentResponse" } } } }, "403": { "description": "403 can be caused for reasons like Access Denied, Unauthorized, Expired Token, Invalid Signature or Resource Not Found.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PurchaseShipmentResponse" } } } }, "404": { "description": "The resource specified does not exist.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PurchaseShipmentResponse" } } } }, "429": { "description": "The frequency of requests was greater than allowed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PurchaseShipmentResponse" } } } }, "500": { "description": "Encountered an unexpected condition which prevented the server from fulfilling the request.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PurchaseShipmentResponse" } } } }, "503": { "description": "Temporary overloading or maintenance of the server.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PurchaseShipmentResponse" } } } } }, "x-codegen-request-body-name": "body" } }, "/shipping/v1/rates": { "post": { "tags": [ "shipping" ], "description": "Get service rates.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 5 | 15 |\n\nFor more information, see \"Usage Plans and Rate Limits\" in the Selling Partner API documentation.", "operationId": "getRates", "requestBody": { "description": "GetRatesRequest body", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetRatesRequest" } } }, "required": true }, "responses": { "200": { "description": "Success.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetRatesResponse" }, "example": { "serviceRates": [ { "billableWeight": { "value": 4, "unit": "kg" }, "totalCharge": { "value": 3.25, "unit": "GBP" }, "serviceType": "Amazon Shipping Standard", "promise": { "deliveryWindow": { "start": "2018-08-25T20:22:30.737Z", "end": "2018-08-26T20:22:30.737Z" }, "receiveWindow": { "start": "2018-08-23T09:22:30.737Z", "end": "2018-08-23T11:22:30.737Z" } } } ] } } } }, "400": { "description": "Request is missing or has invalid parameters and cannot be parsed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetRatesResponse" } } } }, "401": { "description": "The request's Authorization header is not formatted correctly or does not contain a valid token.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetRatesResponse" } } } }, "403": { "description": "403 can be caused for reasons like Access Denied, Unauthorized, Expired Token, Invalid Signature or Resource Not Found.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetRatesResponse" } } } }, "404": { "description": "The resource specified does not exist.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetRatesResponse" } } } }, "429": { "description": "The frequency of requests was greater than allowed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetRatesResponse" } } } }, "500": { "description": "Encountered an unexpected condition which prevented the server from fulfilling the request.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetRatesResponse" } } } }, "503": { "description": "Temporary overloading or maintenance of the server.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetRatesResponse" } } } } }, "x-amzn-api-sandbox": { "dynamic": {} }, "x-codegen-request-body-name": "body" } }, "/shipping/v1/account": { "get": { "tags": [ "shipping" ], "description": "Verify if the current account is valid.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 5 | 15 |\n\nFor more information, see \"Usage Plans and Rate Limits\" in the Selling Partner API documentation.", "operationId": "getAccount", "responses": { "200": { "description": "The account was valid.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetAccountResponse" }, "example": { "accountId": "2755049166" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": {} }, "response": { "payload": { "accountId": "2755049166" } } } ] } }, "400": { "description": "Request has missing or invalid parameters and cannot be parsed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetAccountResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": {} }, "response": { "errors": [ { "code": "InvalidInput", "message": "Invalid input." } ] } } ] } }, "401": { "description": "The request's Authorization header is not formatted correctly or does not contain a valid token.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetAccountResponse" } } } }, "403": { "description": "403 can be caused for reasons like Access Denied, Unauthorized, Expired Token, Invalid Signature or Resource Not Found.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetAccountResponse" } } } }, "404": { "description": "The resource specified does not exist.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetAccountResponse" } } } }, "429": { "description": "The frequency of requests was greater than allowed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetAccountResponse" } } } }, "500": { "description": "Encountered an unexpected condition which prevented the server from fulfilling the request.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetAccountResponse" } } } }, "503": { "description": "Temporary overloading or maintenance of the server.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetAccountResponse" } } } } } } }, "/shipping/v1/tracking/{trackingId}": { "get": { "tags": [ "shipping" ], "description": "Return the tracking information of a shipment.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 1 | 1 |\n\nFor more information, see \"Usage Plans and Rate Limits\" in the Selling Partner API documentation.", "operationId": "getTrackingInformation", "parameters": [ { "name": "trackingId", "in": "path", "description": "Tracking Id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetTrackingInformationResponse" }, "example": { "trackingId": "89108749065090", "eventHistory": [ { "eventCode": "Delivered", "location": { "city": "San Bernardino", "countryCode": "US", "stateOrRegion": "CA", "postalCode": "92404" }, "eventTime": "2019-04-04T06:45:12Z" } ], "promisedDeliveryDate": "2019-04-04T07:05:06Z", "summary": { "status": "Delivered" } } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "trackingId": { "value": "TEST_CASE_200" } } }, "response": { "payload": { "trackingId": "TEST_CASE_200", "eventHistory": [ { "eventCode": "Delivered", "location": { "city": "San Bernardino", "countryCode": "US", "stateOrRegion": "CA", "postalCode": "92404" }, "eventTime": "2019-04-04T06:45:12Z" } ], "promisedDeliveryDate": "2019-04-04T07:05:06Z", "summary": { "status": "Delivered" } } } } ] } }, "400": { "description": "Request has missing or invalid parameters and cannot be parsed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetTrackingInformationResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "trackingId": { "value": "TEST_CASE_400" } } }, "response": { "errors": [ { "code": "InvalidInput", "message": "Invalid Input" } ] } } ] } }, "401": { "description": "The request's Authorization header is not formatted correctly or does not contain a valid token.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetTrackingInformationResponse" } } } }, "403": { "description": "403 can be caused for reasons like Access Denied, Unauthorized, Expired Token, Invalid Signature or Resource Not Found.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetTrackingInformationResponse" } } } }, "404": { "description": "The resource specified does not exist.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetTrackingInformationResponse" } } } }, "429": { "description": "The frequency of requests was greater than allowed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetTrackingInformationResponse" } } } }, "500": { "description": "Encountered an unexpected condition which prevented the server from fulfilling the request.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetTrackingInformationResponse" } } } }, "503": { "description": "Temporary overloading or maintenance of the server.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetTrackingInformationResponse" } } } } } } } }, "components": { "schemas": { "Error": { "required": [ "code", "message" ], "type": "object", "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": "array", "description": "A list of error responses returned when a request is unsuccessful.", "items": { "$ref": "#/components/schemas/Error" } }, "AccountId": { "maxLength": 10, "type": "string", "description": "This is the Amazon Shipping account id generated during the Amazon Shipping onboarding process." }, "ShipmentId": { "type": "string", "description": "The unique shipment identifier." }, "ClientReferenceId": { "maxLength": 40, "type": "string", "description": "Client reference id." }, "ContainerReferenceId": { "maxLength": 40, "type": "string", "description": "An identifier for the container. This must be unique within all the containers in the same shipment." }, "EventCode": { "maxLength": 60, "minLength": 1, "type": "string", "description": "The event code of a shipment, such as Departed, Received, and ReadyForReceive." }, "StateOrRegion": { "type": "string", "description": "The state or region where the person, business or institution is located." }, "City": { "maxLength": 50, "minLength": 1, "type": "string", "description": "The city where the person, business or institution is located." }, "CountryCode": { "maxLength": 2, "minLength": 2, "type": "string", "description": "The two digit country code. In ISO 3166-1 alpha-2 format." }, "PostalCode": { "maxLength": 20, "minLength": 1, "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": "#/components/schemas/StateOrRegion" }, "city": { "$ref": "#/components/schemas/City" }, "countryCode": { "$ref": "#/components/schemas/CountryCode" }, "postalCode": { "$ref": "#/components/schemas/PostalCode" } }, "description": "The location where the person, business or institution is located." }, "Event": { "required": [ "eventCode", "eventTime" ], "type": "object", "properties": { "eventCode": { "$ref": "#/components/schemas/EventCode" }, "eventTime": { "type": "string", "description": "The date and time of an event for a shipment.", "format": "date-time" }, "location": { "$ref": "#/components/schemas/Location" } }, "description": "An event of a shipment" }, "EventList": { "type": "array", "description": "A list of events of a shipment.", "items": { "$ref": "#/components/schemas/Event" } }, "TrackingId": { "maxLength": 60, "minLength": 1, "type": "string", "description": "The tracking id generated to each shipment. It contains a series of letters or digits or both." }, "TrackingSummary": { "type": "object", "properties": { "status": { "maxLength": 60, "minLength": 1, "type": "string", "description": "The derived status based on the events in the eventHistory." } }, "description": "The tracking summary." }, "PromisedDeliveryDate": { "type": "string", "description": "The promised delivery date and time of a shipment.", "format": "date-time" }, "Address": { "required": [ "addressLine1", "city", "countryCode", "name", "postalCode", "stateOrRegion" ], "type": "object", "properties": { "name": { "maxLength": 50, "minLength": 1, "type": "string", "description": "The name of the person, business or institution at that address." }, "addressLine1": { "maxLength": 60, "minLength": 1, "type": "string", "description": "First line of that address." }, "addressLine2": { "maxLength": 60, "minLength": 1, "type": "string", "description": "Additional address information, if required." }, "addressLine3": { "maxLength": 60, "minLength": 1, "type": "string", "description": "Additional address information, if required." }, "stateOrRegion": { "$ref": "#/components/schemas/StateOrRegion" }, "city": { "$ref": "#/components/schemas/City" }, "countryCode": { "$ref": "#/components/schemas/CountryCode" }, "postalCode": { "$ref": "#/components/schemas/PostalCode" }, "email": { "maxLength": 64, "type": "string", "description": "The email address of the contact associated with the address." }, "copyEmails": { "maxItems": 2, "type": "array", "description": "The email cc addresses of the contact associated with the address.", "items": { "maxLength": 64, "type": "string" } }, "phoneNumber": { "maxLength": 20, "minLength": 1, "type": "string", "description": "The phone number of the person, business or institution located at that address." } }, "description": "The address." }, "TimeRange": { "type": "object", "properties": { "start": { "type": "string", "description": "The start date and time. This defaults to the current date and time.", "format": "date-time" }, "end": { "type": "string", "description": "The end date and time. This must come after the value of start. This defaults to the next business day from the start.", "format": "date-time" } }, "description": "The time range." }, "ShippingPromiseSet": { "type": "object", "properties": { "deliveryWindow": { "$ref": "#/components/schemas/TimeRange" }, "receiveWindow": { "$ref": "#/components/schemas/TimeRange" } }, "description": "The promised delivery time and pickup time." }, "ServiceType": { "type": "string", "description": "The type of shipping service that will be used for the service offering.", "enum": [ "Amazon Shipping Ground", "Amazon Shipping Standard", "Amazon Shipping Premium" ], "x-docgen-enum-table-extension": [ { "value": "Amazon Shipping Ground", "description": "Amazon Shipping Ground." }, { "value": "Amazon Shipping Standard", "description": "Amazon Shipping Standard." }, { "value": "Amazon Shipping Premium", "description": "Amazon Shipping Premium." } ] }, "ServiceTypeList": { "type": "array", "description": "A list of service types that can be used to send the shipment.", "items": { "$ref": "#/components/schemas/ServiceType" } }, "Rate": { "type": "object", "properties": { "rateId": { "type": "string", "description": "An identifier for the rate." }, "totalCharge": { "$ref": "#/components/schemas/Currency" }, "billedWeight": { "$ref": "#/components/schemas/Weight" }, "expirationTime": { "type": "string", "description": "The time after which the offering will expire.", "format": "date-time" }, "serviceType": { "$ref": "#/components/schemas/ServiceType" }, "promise": { "$ref": "#/components/schemas/ShippingPromiseSet" } }, "description": "The available rate that can be used to send the shipment" }, "RateList": { "type": "array", "description": "A list of all the available rates that can be used to send the shipment.", "items": { "$ref": "#/components/schemas/Rate" } }, "RateId": { "type": "string", "description": "An identifier for the rating." }, "AcceptedRate": { "type": "object", "properties": { "totalCharge": { "$ref": "#/components/schemas/Currency" }, "billedWeight": { "$ref": "#/components/schemas/Weight" }, "serviceType": { "$ref": "#/components/schemas/ServiceType" }, "promise": { "$ref": "#/components/schemas/ShippingPromiseSet" } }, "description": "The specific rate purchased for the shipment, or null if unpurchased." }, "ServiceRate": { "required": [ "billableWeight", "promise", "serviceType", "totalCharge" ], "type": "object", "properties": { "totalCharge": { "$ref": "#/components/schemas/Currency" }, "billableWeight": { "$ref": "#/components/schemas/Weight" }, "serviceType": { "$ref": "#/components/schemas/ServiceType" }, "promise": { "$ref": "#/components/schemas/ShippingPromiseSet" } }, "description": "The specific rate for a shipping service, or null if no service available." }, "ServiceRateList": { "type": "array", "description": "A list of service rates.", "items": { "$ref": "#/components/schemas/ServiceRate" } }, "Party": { "type": "object", "properties": { "accountId": { "$ref": "#/components/schemas/AccountId" } }, "description": "The account related with the shipment." }, "Currency": { "required": [ "unit", "value" ], "type": "object", "properties": { "value": { "type": "number", "description": "The amount of currency." }, "unit": { "maxLength": 3, "minLength": 3, "type": "string", "description": "A 3-character currency code." } }, "description": "The total value of all items in the container." }, "Dimensions": { "required": [ "height", "length", "unit", "width" ], "type": "object", "properties": { "length": { "type": "number", "description": "The length of the container." }, "width": { "type": "number", "description": "The width of the container." }, "height": { "type": "number", "description": "The height of the container." }, "unit": { "type": "string", "description": "The unit of these measurements.", "enum": [ "IN", "CM" ], "x-docgen-enum-table-extension": [ { "value": "IN", "description": "Inches" }, { "value": "CM", "description": "Centimeters" } ] } }, "description": "A set of measurements for a three-dimensional object." }, "Weight": { "required": [ "unit", "value" ], "type": "object", "properties": { "unit": { "type": "string", "description": "The unit of measurement.", "enum": [ "g", "kg", "oz", "lb" ], "x-docgen-enum-table-extension": [ { "value": "g", "description": "Grams" }, { "value": "kg", "description": "Kilograms" }, { "value": "oz", "description": "Ounces" }, { "value": "lb", "description": "Pounds" } ] }, "value": { "type": "number", "description": "The measurement value." } }, "description": "The weight." }, "ContainerItem": { "required": [ "quantity", "title", "unitPrice", "unitWeight" ], "type": "object", "properties": { "quantity": { "type": "number", "description": "The quantity of the items of this type in the container." }, "unitPrice": { "$ref": "#/components/schemas/Currency" }, "unitWeight": { "$ref": "#/components/schemas/Weight" }, "title": { "maxLength": 30, "type": "string", "description": "A descriptive title of the item." } }, "description": "Item in the container." }, "Container": { "required": [ "containerReferenceId", "dimensions", "items", "value", "weight" ], "type": "object", "properties": { "containerType": { "type": "string", "description": "The type of physical container being used. (always 'PACKAGE')", "enum": [ "PACKAGE" ], "x-docgen-enum-table-extension": [ { "value": "PACKAGE", "description": "PACKAGE" } ] }, "containerReferenceId": { "$ref": "#/components/schemas/ContainerReferenceId" }, "value": { "$ref": "#/components/schemas/Currency" }, "dimensions": { "$ref": "#/components/schemas/Dimensions" }, "items": { "type": "array", "description": "A list of the items in the container.", "items": { "$ref": "#/components/schemas/ContainerItem" } }, "weight": { "$ref": "#/components/schemas/Weight" } }, "description": "Container in the shipment." }, "ContainerList": { "type": "array", "description": "A list of container.", "items": { "$ref": "#/components/schemas/Container" } }, "ContainerSpecification": { "required": [ "dimensions", "weight" ], "type": "object", "properties": { "dimensions": { "$ref": "#/components/schemas/Dimensions" }, "weight": { "$ref": "#/components/schemas/Weight" } }, "description": "Container specification for checking the service rate." }, "ContainerSpecificationList": { "type": "array", "description": "A list of container specifications.", "items": { "$ref": "#/components/schemas/ContainerSpecification" } }, "Label": { "type": "object", "properties": { "labelStream": { "$ref": "#/components/schemas/LabelStream" }, "labelSpecification": { "$ref": "#/components/schemas/LabelSpecification" } }, "description": "The label details of the container." }, "LabelResult": { "type": "object", "properties": { "containerReferenceId": { "$ref": "#/components/schemas/ContainerReferenceId" }, "trackingId": { "type": "string", "description": "The tracking identifier assigned to the container." }, "label": { "$ref": "#/components/schemas/Label" } }, "description": "Label details including label stream, format, size." }, "LabelResultList": { "type": "array", "description": "A list of label results", "items": { "$ref": "#/components/schemas/LabelResult" } }, "LabelStream": { "type": "string", "description": "Contains binary image data encoded as a base-64 string." }, "LabelSpecification": { "required": [ "labelFormat", "labelStockSize" ], "type": "object", "properties": { "labelFormat": { "type": "string", "description": "The format of the label. Enum of PNG only for now.", "enum": [ "PNG" ], "x-docgen-enum-table-extension": [ { "value": "PNG", "description": "PNG" } ] }, "labelStockSize": { "type": "string", "description": "The label stock size specification in length and height. Enum of 4x6 only for now.", "enum": [ "4x6" ], "x-docgen-enum-table-extension": [ { "value": "4x6", "description": "4x6" } ] } }, "description": "The label specification info." }, "CreateShipmentRequest": { "required": [ "clientReferenceId", "containers", "shipFrom", "shipTo" ], "type": "object", "properties": { "clientReferenceId": { "$ref": "#/components/schemas/ClientReferenceId" }, "shipTo": { "$ref": "#/components/schemas/Address" }, "shipFrom": { "$ref": "#/components/schemas/Address" }, "containers": { "$ref": "#/components/schemas/ContainerList" } }, "description": "The request schema for the createShipment operation." }, "PurchaseLabelsRequest": { "required": [ "labelSpecification", "rateId" ], "type": "object", "properties": { "rateId": { "$ref": "#/components/schemas/RateId" }, "labelSpecification": { "$ref": "#/components/schemas/LabelSpecification" } }, "description": "The request schema for the purchaseLabels operation." }, "RetrieveShippingLabelRequest": { "required": [ "labelSpecification" ], "type": "object", "properties": { "labelSpecification": { "$ref": "#/components/schemas/LabelSpecification" } }, "description": "The request schema for the retrieveShippingLabel operation." }, "GetRatesRequest": { "required": [ "containerSpecifications", "serviceTypes", "shipFrom", "shipTo" ], "type": "object", "properties": { "shipTo": { "$ref": "#/components/schemas/Address" }, "shipFrom": { "$ref": "#/components/schemas/Address" }, "serviceTypes": { "$ref": "#/components/schemas/ServiceTypeList" }, "shipDate": { "type": "string", "description": "The start date and time. This defaults to the current date and time.", "format": "date-time" }, "containerSpecifications": { "$ref": "#/components/schemas/ContainerSpecificationList" } }, "description": "The payload schema for the getRates operation." }, "PurchaseShipmentRequest": { "required": [ "clientReferenceId", "containers", "labelSpecification", "serviceType", "shipFrom", "shipTo" ], "type": "object", "properties": { "clientReferenceId": { "$ref": "#/components/schemas/ClientReferenceId" }, "shipTo": { "$ref": "#/components/schemas/Address" }, "shipFrom": { "$ref": "#/components/schemas/Address" }, "shipDate": { "type": "string", "description": "The start date and time. This defaults to the current date and time.", "format": "date-time" }, "serviceType": { "$ref": "#/components/schemas/ServiceType" }, "containers": { "$ref": "#/components/schemas/ContainerList" }, "labelSpecification": { "$ref": "#/components/schemas/LabelSpecification" } }, "description": "The payload schema for the purchaseShipment operation." }, "CreateShipmentResult": { "required": [ "eligibleRates", "shipmentId" ], "type": "object", "properties": { "shipmentId": { "$ref": "#/components/schemas/ShipmentId" }, "eligibleRates": { "$ref": "#/components/schemas/RateList" } }, "description": "The payload schema for the createShipment operation." }, "Shipment": { "required": [ "clientReferenceId", "containers", "shipFrom", "shipTo", "shipmentId" ], "type": "object", "properties": { "shipmentId": { "$ref": "#/components/schemas/ShipmentId" }, "clientReferenceId": { "$ref": "#/components/schemas/ClientReferenceId" }, "shipFrom": { "$ref": "#/components/schemas/Address" }, "shipTo": { "$ref": "#/components/schemas/Address" }, "acceptedRate": { "$ref": "#/components/schemas/AcceptedRate" }, "shipper": { "$ref": "#/components/schemas/Party" }, "containers": { "$ref": "#/components/schemas/ContainerList" } }, "description": "The shipment related data." }, "PurchaseLabelsResult": { "required": [ "acceptedRate", "labelResults", "shipmentId" ], "type": "object", "properties": { "shipmentId": { "$ref": "#/components/schemas/ShipmentId" }, "clientReferenceId": { "$ref": "#/components/schemas/ClientReferenceId" }, "acceptedRate": { "$ref": "#/components/schemas/AcceptedRate" }, "labelResults": { "$ref": "#/components/schemas/LabelResultList" } }, "description": "The payload schema for the purchaseLabels operation." }, "RetrieveShippingLabelResult": { "required": [ "labelSpecification", "labelStream" ], "type": "object", "properties": { "labelStream": { "$ref": "#/components/schemas/LabelStream" }, "labelSpecification": { "$ref": "#/components/schemas/LabelSpecification" } }, "description": "The payload schema for the retrieveShippingLabel operation." }, "Account": { "required": [ "accountId" ], "type": "object", "properties": { "accountId": { "$ref": "#/components/schemas/AccountId" } }, "description": "The account related data." }, "GetRatesResult": { "required": [ "serviceRates" ], "type": "object", "properties": { "serviceRates": { "$ref": "#/components/schemas/ServiceRateList" } }, "description": "The payload schema for the getRates operation." }, "PurchaseShipmentResult": { "required": [ "labelResults", "serviceRate", "shipmentId" ], "type": "object", "properties": { "shipmentId": { "$ref": "#/components/schemas/ShipmentId" }, "serviceRate": { "$ref": "#/components/schemas/ServiceRate" }, "labelResults": { "$ref": "#/components/schemas/LabelResultList" } }, "description": "The payload schema for the purchaseShipment operation." }, "TrackingInformation": { "required": [ "eventHistory", "promisedDeliveryDate", "summary", "trackingId" ], "type": "object", "properties": { "trackingId": { "$ref": "#/components/schemas/TrackingId" }, "summary": { "$ref": "#/components/schemas/TrackingSummary" }, "promisedDeliveryDate": { "$ref": "#/components/schemas/PromisedDeliveryDate" }, "eventHistory": { "$ref": "#/components/schemas/EventList" } }, "description": "The payload schema for the getTrackingInformation operation." }, "CreateShipmentResponse": { "type": "object", "properties": { "payload": { "$ref": "#/components/schemas/CreateShipmentResult" }, "errors": { "$ref": "#/components/schemas/ErrorList" } }, "description": "The response schema for the createShipment operation." }, "GetShipmentResponse": { "type": "object", "properties": { "payload": { "$ref": "#/components/schemas/Shipment" }, "errors": { "$ref": "#/components/schemas/ErrorList" } }, "description": "The response schema for the getShipment operation." }, "GetRatesResponse": { "type": "object", "properties": { "payload": { "$ref": "#/components/schemas/GetRatesResult" }, "errors": { "$ref": "#/components/schemas/ErrorList" } }, "description": "The response schema for the getRates operation." }, "PurchaseShipmentResponse": { "type": "object", "properties": { "payload": { "$ref": "#/components/schemas/PurchaseShipmentResult" }, "errors": { "$ref": "#/components/schemas/ErrorList" } }, "description": "The response schema for the purchaseShipment operation." }, "CancelShipmentResponse": { "type": "object", "properties": { "errors": { "$ref": "#/components/schemas/ErrorList" } }, "description": "The response schema for the cancelShipment operation." }, "PurchaseLabelsResponse": { "type": "object", "properties": { "payload": { "$ref": "#/components/schemas/PurchaseLabelsResult" }, "errors": { "$ref": "#/components/schemas/ErrorList" } }, "description": "The response schema for the purchaseLabels operation." }, "RetrieveShippingLabelResponse": { "type": "object", "properties": { "payload": { "$ref": "#/components/schemas/RetrieveShippingLabelResult" }, "errors": { "$ref": "#/components/schemas/ErrorList" } }, "description": "The response schema for the retrieveShippingLabel operation." }, "GetAccountResponse": { "type": "object", "properties": { "payload": { "$ref": "#/components/schemas/Account" }, "errors": { "$ref": "#/components/schemas/ErrorList" } }, "description": "The response schema for the getAccount operation." }, "GetTrackingInformationResponse": { "type": "object", "properties": { "payload": { "$ref": "#/components/schemas/TrackingInformation" }, "errors": { "$ref": "#/components/schemas/ErrorList" } }, "description": "The response schema for the getTrackingInformation operation." } } }, "x-original-swagger-version": "2.0" }