Amazon SP API
  1. Orders
Amazon SP API
  • Overview
  • Authorization Workflow
  • Permissions
  • Sandbox
  • API Models
  • Available API Models
  • Request Apidog Access
  • OPENAPI SPECIFICATION
  • Research Docs
    • Amazon Seller Order Fulfillment Workflow
  • Amazon Warehousing and Distribution
    • getInboundShipment
      GET
    • listInboundShipments
      GET
    • listInventory
      GET
  • Authorization
    • Authorization
      POST
  • Catalog Items
    • searchCatalogItems
      GET
    • getCatalogItem
      GET
  • Catalog [Deprecated]
    • listCatalogItems
    • getCatalogItem
    • listCatalogCategories
  • Definitions
    • searchDefinitionsProductTypes
    • getDefinitionsProductType
  • Easy Ship
    • listHandoverSlots
    • getScheduledPackage
    • createScheduledPackage
    • updateScheduledPackages
    • createScheduledPackageBulk
  • FBAInbound
    • listInboundPlans
    • createInboundPlan
    • getInboundPlan
    • listInboundPlanBoxes
    • cancelInboundPlan
    • listInboundPlanItems
    • updateInboundPlanName
    • listPackingGroupBoxes
    • listPackingGroupItems
    • setPackingInformation
    • listPackingOptions
    • generatePackingOptions
    • confirmPackingOption
    • listInboundPlanPallets
    • listPlacementOptions
    • generatePlacementOptions
    • confirmPlacementOption
    • getShipment
    • listShipmentBoxes
    • listShipmentContentUpdatePreviews
    • generateShipmentContentUpdatePreviews
    • getShipmentContentUpdatePreview
    • confirmShipmentContentUpdatePreview
    • getDeliveryChallanDocument
    • listDeliveryWindowOptions
    • generateDeliveryWindowOptions
    • confirmDeliveryWindowOptions
    • listShipmentItems
    • updateShipmentName
    • listShipmentPallets
    • cancelSelfShipAppointment
    • getSelfShipAppointmentSlots
    • generateSelfShipAppointmentSlots
    • scheduleSelfShipAppointment
    • updateShipmentSourceAddress
    • updateShipmentTrackingDetails
    • listTransportationOptions
    • generateTransportationOptions
    • confirmTransportationOptions
    • listItemComplianceDetails
    • updateItemComplianceDetails
    • createMarketplaceItemLabels
    • listPrepDetails
    • setPrepDetails
    • getInboundOperationStatus
    • getItemEligibilityPreview
  • FBAInventory
    • getInventorySummaries
    • createInventoryItem
    • deleteInventoryItem
    • addInventory
  • FBAOutbound
    • getFulfillmentPreview
    • deliveryOffers
    • listAllFulfillmentOrders
    • createFulfillmentOrder
    • getPackageTrackingDetails
    • listReturnReasonCodes
    • createFulfillmentReturn
    • getFulfillmentOrder
    • updateFulfillmentOrder
    • cancelFulfillmentOrder
    • submitFulfillmentOrderStatusUpdate
    • getFeatures
    • getFeatureInventory
    • getFeatureSKU
  • Feeds
    • getFeeds
    • createFeed
    • cancelFeed
    • getFeed
    • createFeedDocument
    • getFeedDocument
  • Fees
    • getMyFeesEstimateForSKU
    • getMyFeesEstimateForASIN
    • getMyFeesEstimates
  • Finance
    • listTransactions
    • listFinancialEventGroups
    • listFinancialEventsByGroupId
    • listFinancialEventsByOrderId
    • listFinancialEvents
  • Invoices [Brazil]
    • getInvoicesAttributes
    • getInvoicesDocument
    • createInvoicesExport
    • getInvoicesExports
    • getInvoicesExport
    • getInvoices
    • getInvoice
  • Listings Items
    • getListingsRestrictions
    • deleteListingsItem
    • getListingsItem
    • patchListingsItem
    • putListingsItem
  • Merchant Fulfillment
    • getEligibleShipmentServices
    • getShipment
    • cancelShipment
    • createShipment
    • getAdditionalSellerInputs
  • Orders
    • getOrders
      GET
    • getOrder
      GET
    • getOrderBuyerInfo
      GET
    • getOrderAddress
      GET
    • getOrderItems
      GET
    • getOrderItemsBuyerInfo
      GET
    • updateShipmentStatus
      POST
    • getOrderRegulatedInfo
      GET
    • updateVerificationStatus
      PATCH
    • confirmShipment
      POST
  • ProductPricing
    • deprecated
      • getPricing
      • getCompetitivePricing
      • getListingOffers
      • getItemOffers
      • getItemOffersBatch
      • getListingOffersBatch
    • getFeaturedOfferExpectedPriceBatch
    • getCompetitiveSummary
  • Reports
    • getReports
    • createReport
    • cancelReport
    • getReport
    • getReportSchedules
    • createReportSchedule
    • cancelReportSchedule
    • getReportSchedule
    • getReportDocument
  • Sales
    • getOrderMetrics
  • Sellers
    • getMarketplaceParticipations
    • getAccount
  • Service
    • getServiceJobByServiceJobId
    • cancelServiceJobByServiceJobId
    • completeServiceJobByServiceJobId
    • getServiceJobs
    • addAppointmentForServiceJobByServiceJobId
    • rescheduleAppointmentForServiceJobByServiceJobId
    • assignAppointmentResources
    • setAppointmentFulfillmentData
    • getRangeSlotCapacity
    • getFixedSlotCapacity
    • updateSchedule
    • createReservation
    • updateReservation
    • cancelReservation
    • getAppointmmentSlotsByJobId
    • getAppointmentSlots
    • createServiceDocumentUploadDestination
  • ShipmentInvoice[Brazil]
    • getShipmentDetails
    • submitInvoice
    • getInvoiceStatus
  • Shipping
    • getRates
    • createShipment
    • directPurchaseShipment
    • getShipment
    • purchaseShipment
    • cancelShipment
    • oneClickShipment
    • purchaseLabels
    • getTracking
    • retrieveShippingLabel
    • getShipmentDocuments
    • purchaseShipment
    • cancelShipment
    • getRates
    • getAdditionalInputs
    • getAccount
    • getCarrierAccountFormInputs
    • getTrackingInformation
    • getCarrierAccounts
    • linkCarrierAccount
    • unlinkCarrierAccount
    • generateCollectionForm
    • getCollectionFormHistory
    • getUnmanifestedShipments
    • getCollectionForm
    • getAccessPoints
  • Supply Sources
    • getSupplySources
    • createSupplySource
    • getSupplySource
    • updateSupplySource
    • archiveSupplySource
    • updateSupplySourceStatus
  • Tokens
    • createRestrictedDataToken
  • Uploads
    • createUploadDestinationForResource
  • Notifications
    • getSubscription
    • createSubscription
    • getSubscriptionById
    • deleteSubscriptionById
    • getDestinations
    • createDestination
    • getDestination
    • deleteDestination
  1. Orders

getOrders

Tested
GET
/orders/v0/orders
Last modified:2025-03-14 04:29:29
Maintainer:Sarath S
Returns orders that are created or updated during the specified time period. If you want to return specific types of orders, you can apply filters to your request. NextToken doesn't affect any filters that you include in your request; it only impacts the pagination for the filtered orders response..
Usage Plan:
Rate (requests per second)Burst
0.016720
The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that are applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may receive higher rate and burst values then those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API documentation.

Request

Query Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://sandbox.sellingpartnerapi-na.amazon.com/orders/v0/orders?CreatedAfter=2025-03-10T00:00:00Z&CreatedBefore&LastUpdatedAfter&LastUpdatedBefore&OrderStatuses&MarketplaceIds={{MARKET_USA}}&FulfillmentChannels&PaymentMethods&BuyerEmail&SellerOrderId&MaxResultsPerPage=&EasyShipShipmentStatuses&ElectronicInvoiceStatuses&NextToken&AmazonOrderIds&ActualFulfillmentSupplySourceId&IsISPU&StoreChainStoreId&EarliestDeliveryDateBefore&EarliestDeliveryDateAfter&LatestDeliveryDateBefore&LatestDeliveryDateAfter'

Responses

🟢200OK
application/json
Success.
Headers

Body

Example
{
    "payload": {
        "Orders": [
            {
                "AmazonOrderId": "ut ullamco ut non",
                "SellerOrderId": "est et occaecat",
                "PurchaseDate": "2025-02-01",
                "LastUpdateDate": "2024-04-27",
                "OrderStatus": "InvoiceUnconfirmed",
                "FulfillmentChannel": "MFN",
                "SalesChannel": "pariatur minim Lorem est elit",
                "OrderChannel": "velit ullamco",
                "ShipServiceLevel": "incididunt in magna",
                "OrderTotal": {
                    "CurrencyCode": "WST",
                    "Amount": "ea adipisicing et"
                },
                "NumberOfItemsShipped": 1,
                "NumberOfItemsUnshipped": 64,
                "PaymentExecutionDetail": [
                    {
                        "Payment": {
                            "currencyCode": "GYD",
                            "amount": "ut nisi do nostrud"
                        },
                        "PaymentMethod": "pariatur"
                    },
                    {
                        "Payment": {
                            "currencyCode": "ANG",
                            "amount": "velit officia amet"
                        },
                        "PaymentMethod": "cillum tempor esse amet Excepteur"
                    }
                ],
                "PaymentMethod": "COD",
                "PaymentMethodDetails": [
                    "ea esse",
                    "ullamco"
                ],
                "MarketplaceId": "ut sed eu",
                "ShipmentServiceLevelCategory": "veniam Lorem ullamco minim sed",
                "EasyShipShipmentStatus": "PickedUp",
                "CbaDisplayableShippingLabel": "est minim cupidatat",
                "OrderType": "SourcingOnDemandOrder",
                "EarliestShipDate": "2024-12-30",
                "LatestShipDate": "2024-12-09",
                "EarliestDeliveryDate": "2025-02-08",
                "LatestDeliveryDate": "2024-11-24",
                "IsBusinessOrder": true,
                "IsPrime": true,
                "IsPremiumOrder": true,
                "IsGlobalExpressEnabled": false,
                "ReplacedOrderId": "mollit in aliqua cupidatat",
                "IsReplacementOrder": false,
                "PromiseResponseDueDate": "2025-06-20",
                "IsEstimatedShipDateSet": false,
                "IsSoldByAB": true,
                "IsIBA": true,
                "DefaultShipFromLocationAddress": {
                    "addressLine1": "Maryland Port Gregoryhaven Logan County 19578 Buckridge Orchard Apt. 227",
                    "addressLine2": "Connecticut Dickensville Clark County 680 Erika Trail Apt. 935",
                    "countryCode": "MY",
                    "stateOrProvinceCode": "Texas",
                    "city": "South Augustinestad",
                    "postalCode": "38561-8846"
                },
                "BuyerInvoicePreference": "INDIVIDUAL",
                "BuyerTaxInformation": {
                    "BuyerLegalCompanyName": "Katrina Hessel",
                    "BuyerBusinessAddress": "Arkansas Connstad Polk County 7597 W 5th Street Apt. 601",
                    "BuyerTaxRegistrationId": "id dolore laborum esse incididunt",
                    "BuyerTaxOffice": "nostrud aliquip"
                },
                "FulfillmentInstruction": {
                    "FulfillmentSupplySourceId": "enim adipisicing sed"
                },
                "IsISPU": false,
                "IsAccessPointOrder": true,
                "MarketplaceTaxInfo": {
                    "TaxClassifications": [
                        {
                            "Name": "Justin Langworth IV",
                            "Value": "ad Excepteur ea Lorem irure"
                        }
                    ]
                },
                "SellerDisplayName": "Roderick Murphy",
                "ShippingAddress": {
                    "addressLine1": "South Carolina Eddton Lake County 96682 Baumbach Gardens Apt. 804",
                    "addressLine2": "Vermont East Raphael Johnson County 33709 Ratke Forks Apt. 604",
                    "countryCode": "HT",
                    "stateOrProvinceCode": "Wyoming",
                    "city": "Evalynfort",
                    "postalCode": "07680-8724"
                },
                "BuyerInfo": {
                    "BuyerEmail": "Joyce3@gmail.com",
                    "BuyerName": "Andres Kirlin",
                    "BuyerCounty": "Lawrence County",
                    "BuyerTaxInfo": {
                        "CompanyLegalName": "Priscilla Gorczany",
                        "TaxingRegion": "velit occaecat officia irure veniam",
                        "TaxClassifications": [
                            {
                                "Name": "Marcos Fahey",
                                "Value": "Excepteur aliquip ea aliqua ut"
                            },
                            {
                                "Name": "Ivan Dietrich Sr.",
                                "Value": "et Lorem incididunt dolor magna"
                            }
                        ]
                    },
                    "PurchaseOrderNumber": "81"
                },
                "AutomatedShippingSettings": {
                    "HasAutomatedShippingSettings": true,
                    "AutomatedCarrier": "Hatchback",
                    "AutomatedShipMethod": "in pariatur ex"
                },
                "HasRegulatedItems": false,
                "ElectronicInvoiceStatus": "Errored"
            },
            {
                "AmazonOrderId": "velit in labore ut eiusmod",
                "SellerOrderId": "non nostrud amet",
                "PurchaseDate": "2024-02-23",
                "LastUpdateDate": "2025-10-23",
                "OrderStatus": "PartiallyShipped",
                "FulfillmentChannel": "AFN",
                "SalesChannel": "deserunt laborum amet dolore",
                "OrderChannel": "veniam",
                "ShipServiceLevel": "velit non dolor ad Excepteur",
                "OrderTotal": {
                    "currencyCode": "ISK",
                    "amount": "do proident"
                },
                "NumberOfItemsShipped": 80,
                "NumberOfItemsUnshipped": 66,
                "PaymentExecutionDetail": [
                    {
                        "Payment": {
                            "currencyCode": "BTN",
                            "amount": "esse"
                        },
                        "PaymentMethod": "irure"
                    },
                    {
                        "Payment": {
                            "currencyCode": "SAR",
                            "amount": "tempor et laborum"
                        },
                        "PaymentMethod": "commodo veniam labore aliqua id"
                    }
                ],
                "PaymentMethod": "Other",
                "PaymentMethodDetails": [
                    "anim dolore",
                    "veniam labore sed ea dolor"
                ],
                "MarketplaceId": "sint cupidatat eiusmod Duis in",
                "ShipmentServiceLevelCategory": "velit officia",
                "EasyShipShipmentStatus": "PendingDropOff",
                "CbaDisplayableShippingLabel": "ut ad magna officia adipisicing",
                "OrderType": "StandardOrder",
                "EarliestShipDate": "2024-08-02",
                "LatestShipDate": "2025-09-28",
                "EarliestDeliveryDate": "2025-02-15",
                "LatestDeliveryDate": "2024-12-01",
                "IsBusinessOrder": false,
                "IsPrime": true,
                "IsPremiumOrder": true,
                "IsGlobalExpressEnabled": false,
                "ReplacedOrderId": "elit officia",
                "IsReplacementOrder": false,
                "PromiseResponseDueDate": "2024-11-27",
                "IsEstimatedShipDateSet": true,
                "IsSoldByAB": false,
                "IsIBA": true,
                "DefaultShipFromLocationAddress": {
                    "addressLine1": "Alabama South Alvera Adams County 28326 Mill Street Apt. 120",
                    "addressLine2": "Maine Goldenfort Clay County 3499 Hobart Dale Apt. 901",
                    "countryCode": "PA",
                    "stateOrProvinceCode": "Vermont",
                    "city": "Jazminville",
                    "postalCode": "36484"
                },
                "BuyerInvoicePreference": "INDIVIDUAL",
                "BuyerTaxInformation": {
                    "BuyerLegalCompanyName": "Kendra Simonis",
                    "BuyerBusinessAddress": "Louisiana New Lydiastead Scott County 6413 Rupert Well Apt. 931",
                    "BuyerTaxRegistrationId": "Excepteur ipsum occaecat anim cillum",
                    "BuyerTaxOffice": "ullamco aliquip"
                },
                "FulfillmentInstruction": {
                    "FulfillmentSupplySourceId": "nostrud"
                },
                "IsISPU": true,
                "IsAccessPointOrder": false,
                "MarketplaceTaxInfo": {
                    "TaxClassifications": [
                        {
                            "Name": "Mr. Pedro Erdman",
                            "Value": "eiusmod consectetur sunt voluptate"
                        },
                        {
                            "Name": "Samuel Stoltenberg",
                            "Value": "ad nisi aliquip"
                        },
                        {
                            "Name": "Doug Lindgren III",
                            "Value": "incididunt"
                        }
                    ]
                },
                "SellerDisplayName": "Teresa Shanahan",
                "ShippingAddress": {
                    "addressLine1": "Wyoming Schillertown Warren County 3895 Caesar Lakes Suite 190",
                    "addressLine2": "Oklahoma Port Sterling Crawford County 8442 Union Avenue Apt. 849",
                    "countryCode": "GY",
                    "stateOrProvinceCode": "Iowa",
                    "city": "North Ravenmouth",
                    "postalCode": "19808-5536"
                },
                "BuyerInfo": {
                    "BuyerEmail": "Damon_Walter44@hotmail.com",
                    "BuyerName": "Dustin Collier",
                    "BuyerCounty": "Warren County",
                    "BuyerTaxInfo": {
                        "CompanyLegalName": "Gregory Corkery-Yundt",
                        "TaxingRegion": "reprehenderit amet tempor anim exercitation",
                        "TaxClassifications": [
                            {
                                "Name": "Perry Keeling",
                                "Value": "dolore in ex adipisicing irure"
                            },
                            {
                                "Name": "Israel Baumbach",
                                "Value": "eiusmod"
                            }
                        ]
                    },
                    "PurchaseOrderNumber": "7"
                },
                "AutomatedShippingSettings": {
                    "HasAutomatedShippingSettings": true,
                    "AutomatedCarrier": "SUV",
                    "AutomatedShipMethod": "sit anim adipisicing sint"
                },
                "HasRegulatedItems": false,
                "ElectronicInvoiceStatus": "NotFound"
            }
        ],
        "NextToken": "nulla",
        "LastUpdatedBefore": "2025-05-01",
        "CreatedBefore": "aute"
    },
    "errors": [
        {
            "code": "22",
            "message": "Thermae ad consuasor studio decens verumtamen crastinus fuga. Depono solus calculus. Vindico umerus casso delicate.",
            "details": "et adipisicing eu"
        },
        {
            "code": "93",
            "message": "Aro conspergo traho totidem concido vulgo cubicularis verbum crebro succurro. Corroboro patrocinor cur contabesco utilis viridis. Perspiciatis suasoria cilicium consequatur unus abscido templum trado vito maiores.",
            "details": "adipisicing sint"
        }
    ]
}
🟠400Bad Request
🟠403Forbidden
🟠404Record Not Found
🟠429429
🔴500Server Error
🔴503Service Unavailable
Modified at 2025-03-14 04:29:29
Previous
Orders
Next
getOrder
Built with