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

getOrder

Tested
GET
/orders/v0/orders/{orderId}
Orders
Last modified:2025-03-13 11:57:49
Maintainer:Sarath S
Returns the order that you specify.
Usage Plan:
Rate (requests per second)Burst
0.530
The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were 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.

Request

Path Params
orderId
string 
required
An Amazon-defined order identifier, in 3-7-7 format.
Example:
111-7275106-9886637

Request 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 --request GET 'https://sandbox.sellingpartnerapi-na.amazon.com/orders/v0/orders/111-7275106-9886637'

Responses

🟢200OK
application/json
Success.
Headers
x-amzn-RateLimit-Limit
string 
optional
Your rate limit (requests per second) for this operation.
x-amzn-RequestId
string 
optional
Unique request reference identifier.
Body
payload
object 
required
AmazonOrderId
string 
required
PurchaseDate
string 
required
LastUpdateDate
string 
required
OrderStatus
string 
required
FulfillmentChannel
string 
required
SalesChannel
string 
required
ShipServiceLevel
string 
required
OrderTotal
object 
required
NumberOfItemsShipped
integer 
required
NumberOfItemsUnshipped
integer 
required
PaymentMethod
string 
required
PaymentMethodDetails
array[string]
required
IsReplacementOrder
boolean 
required
MarketplaceId
string 
required
ShipmentServiceLevelCategory
string 
required
OrderType
string 
required
EarliestShipDate
string 
required
LatestShipDate
string 
required
EarliestDeliveryDate
string 
required
LatestDeliveryDate
string 
required
IsBusinessOrder
boolean 
required
IsPrime
boolean 
required
IsGlobalExpressEnabled
boolean 
required
IsPremiumOrder
boolean 
required
IsSoldByAB
boolean 
required
IsIBA
boolean 
required
DefaultShipFromLocationAddress
object 
required
FulfillmentInstruction
object 
required
IsISPU
boolean 
required
IsAccessPointOrder
boolean 
required
AutomatedShippingSettings
object 
required
EasyShipShipmentStatus
string 
required
ElectronicInvoiceStatus
string 
required
Example
{
    "payload": {
        "AmazonOrderId": "902-3159896-1390916",
        "PurchaseDate": "2017-01-20T19:49:35Z",
        "LastUpdateDate": "2017-01-20T19:49:35Z",
        "OrderStatus": "Pending",
        "FulfillmentChannel": "SellerFulfilled",
        "NumberOfItemsShipped": 0,
        "NumberOfItemsUnshipped": 0,
        "PaymentMethod": "Other",
        "PaymentMethodDetails": [
            "CreditCard",
            "GiftCerificate"
        ],
        "MarketplaceId": "ATVPDKIKX0DER",
        "ShipmentServiceLevelCategory": "Standard",
        "OrderType": "StandardOrder",
        "EarliestShipDate": "2017-01-20T19:51:16Z",
        "LatestShipDate": "2017-01-25T19:49:35Z",
        "IsBusinessOrder": false,
        "IsPrime": false,
        "IsGlobalExpressEnabled": false,
        "IsPremiumOrder": false,
        "IsSoldByAB": false,
        "IsIBA": false,
        "DefaultShipFromLocationAddress": {
            "Name": "MFNIntegrationTestMerchant",
            "AddressLine1": "2201 WESTLAKE AVE",
            "City": "SEATTLE",
            "StateOrRegion": "WA",
            "PostalCode": "98121-2778",
            "CountryCode": "US",
            "Phone": "+1 480-386-0930 ext. 73824",
            "AddressType": "Commercial"
        },
        "FulfillmentInstruction": {
            "FulfillmentSupplySourceId": "sampleSupplySourceId"
        },
        "IsISPU": false,
        "IsAccessPointOrder": false,
        "ShippingAddress": {
            "Name": "Michigan address",
            "AddressLine1": "1 Cross St.",
            "City": "Canton",
            "StateOrRegion": "MI",
            "PostalCode": "48817",
            "CountryCode": "US"
        },
        "BuyerInfo": {
            "BuyerEmail": "user@example.com",
            "BuyerName": "John Doe",
            "BuyerTaxInfo": {
                "CompanyLegalName": "A Company Name"
            },
            "PurchaseOrderNumber": "1234567890123"
        },
        "AutomatedShippingSettings": {
            "HasAutomatedShippingSettings": false
        }
    }
}
🟠400Bad Request
🟠403Forbidden
🟠404Record Not Found
🟠429429
🔴500Server Error
🔴503Service Unavailable
Previous
getOrders
Next
getOrderBuyerInfo
Built with