Amazon Seller Central

App · 23 actions

Run your Amazon store: list and ship orders, request reviews, manage listings, prices and stock, search the catalog, check competitors' prices and fees, download reports and read your finances.

Actions

ActionWhat it does
Confirm shipmentTell Amazon an order you fulfil has shipped, with the carrier and tracking number.
Create or replace listingCreate a listing for a SKU, or replace all of an existing one, from its product type and attributes in Amazon's listing format.
Create reportAsk Amazon to build a report, such as all orders or all listings, for a period.
Delete listingDelete your listing for a SKU from a marketplace.
Download reportDownload a finished report and read it: a table becomes rows keyed by column name, a JSON report becomes data, anything else text.
Estimate feesEstimate Amazon's fees (referral, FBA and the rest) for selling a product at a price, and what you would keep.
Get balancesGet your seller account's balances now: the total, what is available to pay out, and what Amazon is holding back.
Get catalog itemGet a product from Amazon's catalog by ASIN: title, brand, product type, image, codes, sales rank and its full attributes.
Get competitive pricingGet the Buy Box and other competitive prices, offer counts and sales rank for up to 20 products, by ASIN or your SKU.
Get financial summaryGet what you made over a period after Amazon's fees, broken down into sales, refunds, fees and the rest.
Get listingGet one listing by SKU with its status, price, quantity, issues and all its attributes.
Get offersGet the lowest offers on a product, who holds the Buy Box and at what price, by ASIN or your SKU.
Get orderGet one order with its items, totals, ship-by date, packages and tracking numbers.
Get reportGet a report's status, and whether it is ready to download.
List FBA inventoryList the stock Amazon holds for you (FBA) per SKU: ready to ship, on its way in, reserved and unsellable.
List listingsList your listings with their title, price, quantity, buyable status and any errors, most recently changed first.
List marketplacesList the Amazon marketplaces your account sells in, with each one's ID, currency and website.
List ordersList orders placed, or changed, in a period (the last 7 days unless you set one), filtered by status, who fulfils them and marketplace.
List reportsList reports of one type made in the last 90 days, by you or by Amazon's schedules, newest first.
List transactionsList money in and out of your seller account (sales, refunds, fees, payouts) posted in a period, the last 7 days unless you set one, or for one order.
Request a reviewHave Amazon email the buyer its standard request for a product review and seller feedback.
Search catalogSearch Amazon's catalog by keywords, or look products up by codes such as UPC, EAN or ASIN, with title, brand, image and sales rank.
Update price and quantityChange a listing's price, the quantity you have to ship, or both.

Confirm shipment

Tell Amazon an order you fulfil has shipped, with the carrier and tracking number. Ships every item still to ship unless you list item IDs. Amazon then updates the order and tells the buyer.

Inputs

Order IDorder_idtextRequired
Amazon's order ID, like 123-1234567-1234567, from 'List orders', a trigger or Seller Central.
CarriercarriertextRequired
The carrier. Pick one, or type the carrier code Amazon uses. For a carrier Amazon doesn't list, pick Other and give its name.
Tracking numbertracking_numbertextRequired
The package's tracking number.
Carrier namecarrier_nametext
The carrier's name, needed when the carrier is Other.
Shipping serviceshipping_methodtext
The service used, such as Priority Mail.
Shipped atship_datedate and time
When the package shipped. Defaults to now.
Only these itemsorder_item_idslist
The order_item_id of each item in this package, from 'Get order'. Leave empty to ship everything still to ship.
Package numberpackage_numbernumber
Numbers each package of one order: 1 for the first, 2 for a second package, and so on. Defaults to 1.From 1 to 999.

Outputs

carriertext
The carrier code sent
confirmedtrue/false
True once Amazon accepted the confirmation
itemslist
What was confirmed as shipped
order_idtext
The order
ship_datetext
When it shipped (UTC)
tracking_numbertext
The tracking number sent
Example output
{
  "carrier": "UPS",
  "confirmed": true,
  "items": [
    {
      "order_item_id": "12345678901234",
      "quantity": 2
    }
  ],
  "order_id": "123-4567890-1234567",
  "ship_date": "2026-10-21T15:00:00Z",
  "tracking_number": "1Z999AA10123456784"
}

Create or replace listing

Create a listing for a SKU, or replace all of an existing one, from its product type and attributes in Amazon's listing format. Choose 'Only check it' to see Amazon's errors without changing anything.

Inputs

SKUskutextRequired
Your SKU for the listing, from 'List listings' or Seller Central.
Product typeproduct_typetextRequired
Amazon's product type, such as LUGGAGE or SHIRT. 'Get catalog item' shows a product's type.
AttributesattributesobjectRequired
The listing's attributes in Amazon's listing format, such as {"condition_type": [{"value": "new_new"}], "merchant_suggested_asin": [{"value": "B071VG5N9D"}]}. 'Get listing' shows an existing listing's.
Listing kindrequirementstext
A new product with your offer, an offer on a product already on Amazon, or a product with no offer yet. Defaults to product and offer.One of: LISTING (Product and offer), LISTING_OFFER_ONLY (Offer only (product already on Amazon)), LISTING_PRODUCT_ONLY (Product only, no offer). Default: LISTING.
Modemodetext
Save the change, or only have Amazon check it and report problems without changing anything.One of: save (Save the change), check (Only check it (nothing changes)). Default: save.
Marketplacemarketplace_idtext
The marketplace, such as Amazon.com. Leave empty for your main marketplace in the connection's region.

Outputs

resultobject
What Amazon made of it
Example output
{
  "result": {
    "asin": "B071VG5N9D",
    "checked_only": true,
    "has_errors": false,
    "issues": [],
    "sku": "GM-ZDPI-9B4E",
    "status": "VALID",
    "submission_id": "f1dc2914-75dd-11ea-bc55-0242ac130003"
  }
}

Create report

Ask Amazon to build a report, such as all orders or all listings, for a period. It takes seconds to many minutes: check it with 'Get report', then use 'Download report'.

Inputs

Reportreport_typetextRequired
The report, such as All listings. Pick one, or type any Amazon report type such as GET_MERCHANT_LISTINGS_ALL_DATA.
Fromstart_timedate and time
Start of the period it covers, for reports that take one.
Toend_timedate and time
End of the period it covers.
Marketplacemarketplace_idtext
The marketplace, such as Amazon.com. Leave empty for your main marketplace in the connection's region.

Outputs

report_idtext
The new report's ID
report_typetext
The report type
statustext
IN_QUEUE: Amazon has started on it
Example output
{
  "report_id": "ReportId1",
  "report_type": "GET_MERCHANT_LISTINGS_ALL_DATA",
  "status": "IN_QUEUE"
}

Delete listing

Delete your listing for a SKU from a marketplace.

Inputs

SKUskutextRequired
Your SKU for the listing, from 'List listings' or Seller Central.
Marketplacemarketplace_idtext
The marketplace, such as Amazon.com. Leave empty for your main marketplace in the connection's region.

Outputs

resultobject
What Amazon made of it
Example output
{
  "result": {
    "asin": "",
    "checked_only": false,
    "has_errors": false,
    "issues": [],
    "sku": "GM-ZDPI-9B4E",
    "status": "ACCEPTED",
    "submission_id": "f1dc2914-75dd-11ea-bc55-0242ac130003"
  }
}

Download report

Download a finished report and read it: a table becomes rows keyed by column name, a JSON report becomes data, anything else text.

Inputs

Report IDreport_idtextRequired
The report's ID, from 'Create report' or 'List reports'.
Maximum rowsmax_rowsnumber
Most rows to return, 1 to 10000. Defaults to 1000.From 1 to 10000.

Outputs

columnslist
The table's column names
dataobject
A JSON report's contents
formattext
tsv (a table), json, xml or text
report_idtext
The report
report_typetext
The report type
row_countnumber
How many rows the report has
rowslist
The table's rows, each keyed by column name
texttext
An XML or text report's contents
truncatedtrue/false
True when not every row or all the text was returned
Example output
{
  "columns": [
    "item-name",
    "seller-sku",
    "price",
    "quantity",
    "asin1"
  ],
  "data": {},
  "format": "tsv",
  "report_id": "ReportId1",
  "report_type": "GET_MERCHANT_LISTINGS_ALL_DATA",
  "row_count": 1,
  "rows": [
    {
      "asin1": "B071VG5N9D",
      "item-name": "Hardside Carry-On Spinner Suitcase Luggage",
      "price": "100.00",
      "quantity": "100",
      "seller-sku": "GM-ZDPI-9B4E"
    }
  ],
  "text": "",
  "truncated": false
}

Estimate fees

Estimate Amazon's fees (referral, FBA and the rest) for selling a product at a price, and what you would keep.

Inputs

ProductidentifiertextRequired
The ASIN, or your SKU if you look up by SKU.
PricepricenumberRequired
The selling price in the marketplace's currency, such as 19.99.At least 0.
Look up byidentifier_typetext
Whether the product is given by ASIN or by your SKU.One of: ASIN, SKU (Your SKU). Default: ASIN.
Shipping chargeshippingnumber
What the buyer pays for shipping. Defaults to 0.At least 0.
Fulfilled by Amazonfulfilled_by_amazontrue/false
Include FBA fees, for a product Amazon ships.Default: false.
Marketplacemarketplace_idtext
The marketplace, such as Amazon.com. Leave empty for your main marketplace in the connection's region.

Outputs

estimateobject
The estimate
Example output
{
  "estimate": {
    "currency": "USD",
    "fees": [
      {
        "amount": 3.0,
        "fee_type": "ReferralFee"
      }
    ],
    "identifier": "B00V5DG6IQ",
    "price": 10.0,
    "proceeds": 7.0,
    "shipping": 0.0,
    "status": "Success",
    "total_fees": 3.0
  }
}

Get balances

Get your seller account's balances now: the total, what is available to pay out, and what Amazon is holding back.

Inputs

Marketplacemarketplace_idtext
Only this marketplace. Leave empty for all of them.

Outputs

balanceslist
Each balance
countnumber
How many were returned
Example output
{
  "balances": [
    {
      "account_type": "Standard Orders",
      "amount": 15000,
      "balance_type": "TOTAL",
      "currency": "USD",
      "last_updated_time": "2026-10-12T10:30:00+09:00",
      "marketplace_id": "ATVPDKIKX0DER"
    },
    {
      "account_type": "Standard Orders",
      "amount": 8000,
      "balance_type": "AVAILABLE",
      "currency": "USD",
      "last_updated_time": "",
      "marketplace_id": "ATVPDKIKX0DER"
    },
    {
      "account_type": "Standard Orders",
      "amount": 7000,
      "balance_type": "RESERVED",
      "currency": "USD",
      "last_updated_time": "",
      "marketplace_id": "ATVPDKIKX0DER"
    }
  ],
  "count": 3
}

Get catalog item

Get a product from Amazon's catalog by ASIN: title, brand, product type, image, codes, sales rank and its full attributes.

Inputs

ASINasintextRequired
The product's ASIN, such as B08N5WRWNW.
Marketplacemarketplace_idtext
The marketplace, such as Amazon.com. Leave empty for your main marketplace in the connection's region.

Outputs

attributesobject
All the product's attributes, as Amazon has them
itemobject
The product
Example output
{
  "attributes": {
    "brand": [
      {
        "language_tag": "en_US",
        "marketplace_id": "ATVPDKIKX0DER",
        "value": "SAMSUNG"
      }
    ]
  },
  "item": {
    "asin": "B07N4M94X4",
    "brand": "SAMSUNG",
    "category": "QLED TVs",
    "color": "Black",
    "identifiers": [
      {
        "type": "UPC",
        "value": "887276302195"
      }
    ],
    "image_url": "https://m.media-amazon.com/images/I/51DZzp3w3vL.jpg",
    "item_classification": "BASE_PRODUCT",
    "manufacturer": "Samsung",
    "model_number": "QN82Q60RAFXZA",
    "product_type": "TELEVISION",
    "sales_rank": 72855,
    "sales_rank_category": "Electronics",
    "size": "82-Inch",
    "title": "Samsung QN82Q60RAFXZA Flat 82-Inch QLED 4K Q60 Series"
  }
}

Get competitive pricing

Get the Buy Box and other competitive prices, offer counts and sales rank for up to 20 products, by ASIN or your SKU.

Inputs

ProductsidentifierslistRequired
Up to 20 ASINs, or SKUs if you look up by SKU.
Look up byidentifier_typetext
Whether the product is given by ASIN or by your SKU.One of: ASIN, SKU (Your SKU). Default: ASIN.
Prices forcustomer_typetext
Prices consumers see, or business buyers. Defaults to consumers.One of: Consumer (Consumers), Business (Business buyers).
Marketplacemarketplace_idtext
The marketplace, such as Amazon.com. Leave empty for your main marketplace in the connection's region.

Outputs

countnumber
How many were returned
productslist
Each product's prices
Example output
{
  "count": 1,
  "products": [
    {
      "asin": "B00V5DG6IQ",
      "competitive_prices": [
        {
          "condition": "new",
          "currency": "USD",
          "is_mine": true,
          "landed_price": 24.99,
          "listing_price": 19.99,
          "price_id": "1",
          "shipping": 5.0
        }
      ],
      "offer_counts": [
        {
          "condition": "new",
          "count": 20
        }
      ],
      "sales_rank": 1520,
      "sales_rank_category": "toy_display_on_website",
      "sku": "",
      "status": "Success"
    }
  ]
}

Get financial summary

Get what you made over a period after Amazon's fees, broken down into sales, refunds, fees and the rest.

Inputs

Fromstart_datedate
First day of the period.
Toend_datedate
Last day of the period.
Marketplacemarketplace_idtext
Only this marketplace. Leave empty for all of them.

Outputs

countnumber
How many were returned
summarieslist
One per account and marketplace
Example output
{
  "count": 1,
  "summaries": [
    {
      "account_type": "Standard Orders",
      "breakdowns": [
        {
          "amount": 9000,
          "details": [
            {
              "amount": 9000,
              "type": "Product Charges"
            }
          ],
          "type": "Sales"
        },
        {
          "amount": -1000,
          "details": [
            {
              "amount": -1000,
              "type": "FBA fees"
            }
          ],
          "type": "Expenses"
        }
      ],
      "currency": "USD",
      "marketplace_id": "ATVPDKIKX0DER",
      "net_proceeds": 8000,
      "period_end": "2026-10-14",
      "period_start": "2026-10-01",
      "settlement_id": ""
    }
  ]
}

Get listing

Get one listing by SKU with its status, price, quantity, issues and all its attributes.

Inputs

SKUskutextRequired
Your SKU for the listing, from 'List listings' or Seller Central.
Marketplacemarketplace_idtext
The marketplace, such as Amazon.com. Leave empty for your main marketplace in the connection's region.

Outputs

listingobject
The listing
Example output
{
  "listing": {
    "asin": "B071VG5N9D",
    "attributes": {
      "item_name": [
        {
          "language_tag": "en_US",
          "marketplace_id": "ATVPDKIKX0DER",
          "value": "Hardside Carry-On Spinner Suitcase Luggage"
        }
      ]
    },
    "condition": "new_new",
    "created_date": "2021-02-01T00:00:00Z",
    "currency": "USD",
    "error_count": 1,
    "fn_sku": "",
    "fulfillment_channel": "DEFAULT",
    "image_url": "https://www.example.com/luggage.png",
    "is_buyable": true,
    "issues": [
      {
        "attributes": [
          "size"
        ],
        "code": "90220",
        "message": "'size' is required but not supplied.",
        "severity": "ERROR"
      }
    ],
    "last_updated_date": "2021-03-01T00:00:00Z",
    "price": 100.0,
    "product_type": "LUGGAGE",
    "quantity": 100,
    "sku": "GM-ZDPI-9B4E",
    "statuses": [
      "BUYABLE",
      "DISCOVERABLE"
    ],
    "title": "Hardside Carry-On Spinner Suitcase Luggage"
  }
}

Get offers

Get the lowest offers on a product, who holds the Buy Box and at what price, by ASIN or your SKU.

Inputs

ProductidentifiertextRequired
The ASIN, or your SKU if you look up by SKU.
Look up byidentifier_typetext
Whether the product is given by ASIN or by your SKU.One of: ASIN, SKU (Your SKU). Default: ASIN.
Conditionconditiontext
Offers in this condition. Defaults to new.One of: New, Used, Collectible, Refurbished, Club. Default: New.
Prices forcustomer_typetext
Prices consumers see, or business buyers. Defaults to consumers.One of: Consumer (Consumers), Business (Business buyers).
Marketplacemarketplace_idtext
The marketplace, such as Amazon.com. Leave empty for your main marketplace in the connection's region.

Outputs

resultobject
The offers
Example output
{
  "result": {
    "asin": "B00V5DG6IQ",
    "buy_box_price": 10.0,
    "condition": "New",
    "currency": "USD",
    "lowest_price": 10.0,
    "offers": [
      {
        "condition": "new",
        "feedback_count": 120,
        "feedback_rating": 98.0,
        "is_buy_box_winner": true,
        "is_fba": false,
        "is_mine": true,
        "is_prime": false,
        "price": 10.0,
        "seller_id": "AXXXXXXXXXXXXX",
        "shipping": 0.0,
        "total_price": 10.0
      }
    ],
    "sku": "",
    "status": "Success",
    "total_offer_count": 1
  }
}

Get order

Get one order with its items, totals, ship-by date, packages and tracking numbers.

Inputs

Order IDorder_idtextRequired
Amazon's order ID, like 123-1234567-1234567, from 'List orders', a trigger or Seller Central.
Include buyer and addressinclude_buyer_infotrue/false
Also return the buyer's name, email and shipping address. Amazon gives them only to apps with its restricted roles.Default: false.

Outputs

orderobject
The order
Example output
{
  "order": {
    "buyer_email": "",
    "buyer_name": "",
    "created_time": "2026-10-20T10:30:00Z",
    "currency": "USD",
    "deliver_by": "2026-10-27T23:59:59Z",
    "fulfilled_by": "MERCHANT",
    "is_business_order": false,
    "is_prime": true,
    "item_count": 2,
    "items": [
      {
        "asin": "B08N5WRWNW",
        "condition": "NEW",
        "currency": "USD",
        "order_item_id": "12345678901234",
        "quantity": 2,
        "quantity_shipped": 0,
        "quantity_to_ship": 2,
        "sku": "ECHO-DOT-4-CHARCOAL",
        "title": "Echo Dot (4th Gen) | Smart speaker with Alexa | Charcoal",
        "unit_price": 49.99
      }
    ],
    "last_updated_time": "2026-10-20T14:45:00Z",
    "marketplace_id": "ATVPDKIKX0DER",
    "marketplace_name": "Amazon.com",
    "order": {
      "createdTime": "2026-10-20T10:30:00Z",
      "fulfillment": {
        "deliverByWindow": {
          "earliestDateTime": "2026-10-24T00:00:00Z",
          "latestDateTime": "2026-10-27T23:59:59Z"
        },
        "fulfilledBy": "MERCHANT",
        "fulfillmentServiceLevel": "STANDARD",
        "fulfillmentStatus": "UNSHIPPED",
        "shipByWindow": {
          "earliestDateTime": "2026-10-21T00:00:00Z",
          "latestDateTime": "2026-10-22T23:59:59Z"
        }
      },
      "lastUpdatedTime": "2026-10-20T14:45:00Z",
      "orderId": "123-4567890-1234567",
      "orderItems": [
        {
          "fulfillment": {
            "quantityFulfilled": 0,
            "quantityUnfulfilled": 2
          },
          "orderItemId": "12345678901234",
          "product": {
            "asin": "B08N5WRWNW",
            "condition": {
              "conditionType": "NEW"
            },
            "price": {
              "unitPrice": {
                "amount": "49.99",
                "currencyCode": "USD"
              }
            },
            "sellerSku": "ECHO-DOT-4-CHARCOAL",
            "title": "Echo Dot (4th Gen) | Smart speaker with Alexa | Charcoal"
          },
          "quantityOrdered": 2
        }
      ],
      "packages": [],
      "proceeds": {
        "grandTotal": {
          "amount": "104.98",
          "currencyCode": "USD"
        }
      },
      "programs": [
        "PRIME"
      ],
      "salesChannel": {
        "channelName": "AMAZON",
        "marketplaceId": "ATVPDKIKX0DER",
        "marketplaceName": "Amazon.com"
      }
    },
    "order_id": "123-4567890-1234567",
    "order_total": 104.98,
    "programs": [
      "PRIME"
    ],
    "service_level": "STANDARD",
    "ship_by": "2026-10-22T23:59:59Z",
    "ship_to_city": "",
    "ship_to_country": "",
    "ship_to_name": "",
    "ship_to_postal_code": "",
    "ship_to_state": "",
    "status": "UNSHIPPED",
    "tracking_numbers": []
  }
}

Get report

Get a report's status, and whether it is ready to download.

Inputs

Report IDreport_idtextRequired
The report's ID, from 'Create report' or 'List reports'.

Outputs

is_readytrue/false
True when it can be downloaded
reportobject
The report
Example output
{
  "is_ready": true,
  "report": {
    "created_time": "2026-10-12T13:47:20.677Z",
    "data_end_time": "2026-10-12T13:47:20.677Z",
    "data_start_time": "2026-10-11T13:47:20.677Z",
    "document_id": "0356cf79-b8b0-4226-b4b9-0ee058ea5760",
    "marketplace_ids": [
      "ATVPDKIKX0DER"
    ],
    "processing_end_time": "2026-10-12T13:48:20.677Z",
    "processing_start_time": "2026-10-12T13:47:25.000Z",
    "report_id": "ReportId1",
    "report_type": "GET_MERCHANT_LISTINGS_ALL_DATA",
    "status": "DONE"
  }
}

List FBA inventory

List the stock Amazon holds for you (FBA) per SKU: ready to ship, on its way in, reserved and unsellable.

Inputs

Marketplacemarketplace_idtext
The marketplace, such as Amazon.com. Leave empty for your main marketplace in the connection's region.
SKUsskuslist
Only these SKUs, up to 50. Leave empty for all.
Changed sincechanged_sincedate and time
Only SKUs whose stock changed after this time.
Maximummax_resultsnumber
Most SKUs to return, 1 to 500. Defaults to 100.From 1 to 500.

Outputs

countnumber
How many were returned
has_moretrue/false
True when Amazon has more than were returned; raise the maximum or narrow the search to see them
itemslist
Stock per SKU
Example output
{
  "count": 1,
  "has_more": false,
  "items": [
    {
      "asin": "B0020MLK00",
      "condition": "NewItem",
      "fn_sku": "X0000000FN",
      "fulfillable_quantity": 20,
      "inbound_quantity": 5,
      "last_updated_time": "2026-10-20T08:00:00Z",
      "product_name": "Sample product",
      "researching_quantity": 0,
      "reserved_quantity": 2,
      "sku": "SKU-SAMPLE-1",
      "total_quantity": 28,
      "unfulfillable_quantity": 1
    }
  ]
}

List listings

List your listings with their title, price, quantity, buyable status and any errors, most recently changed first.

Inputs

Marketplacemarketplace_idtext
The marketplace, such as Amazon.com. Leave empty for your main marketplace in the connection's region.
Showshowtext
All listings, or only buyable ones, unbuyable ones or ones with errors.One of: all (All listings), buyable, not_buyable (Not buyable), errors (With errors). Default: all.
SKUsskuslist
Only these SKUs, up to 20. Leave empty for all.
Changed sincechanged_sincedate and time
Only listings changed after this time.
Ordersort_bytext
How to sort them. Defaults to recently changed first.One of: lastUpdatedDate (Recently changed first), createdDate (Newest first), sku (By SKU). Default: lastUpdatedDate.
Maximummax_resultsnumber
Most listings to return, 1 to 200. Defaults to 50.From 1 to 200.

Outputs

countnumber
How many were returned
has_moretrue/false
True when Amazon has more than were returned; raise the maximum or narrow the search to see them
listingslist
The listings
Example output
{
  "count": 1,
  "has_more": false,
  "listings": [
    {
      "asin": "B071VG5N9D",
      "attributes": {},
      "condition": "new_new",
      "created_date": "2021-02-01T00:00:00Z",
      "currency": "USD",
      "error_count": 1,
      "fn_sku": "",
      "fulfillment_channel": "DEFAULT",
      "image_url": "https://www.example.com/luggage.png",
      "is_buyable": true,
      "issues": [
        {
          "attributes": [
            "size"
          ],
          "code": "90220",
          "message": "'size' is required but not supplied.",
          "severity": "ERROR"
        }
      ],
      "last_updated_date": "2021-03-01T00:00:00Z",
      "price": 100.0,
      "product_type": "LUGGAGE",
      "quantity": 100,
      "sku": "GM-ZDPI-9B4E",
      "statuses": [
        "BUYABLE",
        "DISCOVERABLE"
      ],
      "title": "Hardside Carry-On Spinner Suitcase Luggage"
    }
  ]
}

List marketplaces

List the Amazon marketplaces your account sells in, with each one's ID, currency and website. Use an ID in any step's Marketplace field.

Inputs

None.

Outputs

countnumber
How many were returned
marketplaceslist
Your marketplaces
Example output
{
  "count": 1,
  "marketplaces": [
    {
      "country_code": "US",
      "currency": "USD",
      "domain": "www.amazon.com",
      "has_suspended_listings": false,
      "is_participating": true,
      "language": "en_US",
      "marketplace_id": "ATVPDKIKX0DER",
      "name": "Amazon.com",
      "store_name": "BestSellerStore"
    }
  ]
}

List orders

List orders placed, or changed, in a period (the last 7 days unless you set one), filtered by status, who fulfils them and marketplace. Each order comes with its items and totals.

Inputs

Find ordersdate_filtertext
Orders placed in the period, or orders that changed in it (shipped, cancelled and so on). Defaults to placed.One of: created (Placed in the period), updated (Changed in the period). Default: created.
Fromfrom_timedate and time
Start of the period. Defaults to 7 days ago.
Toto_timedate and time
End of the period. Defaults to now.
Statusesstatuseslist
Only orders in these statuses. Leave empty for all.One or more of: PENDING (Pending (not yet paid)), UNSHIPPED (Unshipped (ready to ship)), PARTIALLY_SHIPPED (Partially shipped), SHIPPED, CANCELLED, UNFULFILLABLE, PENDING_AVAILABILITY (Pre-order, not yet released).
Fulfilled byfulfilled_bytext
Only orders you ship, or only orders Amazon ships (FBA).One of: MERCHANT (You (merchant fulfilled)), AMAZON (Amazon (FBA)).
Marketplacemarketplace_idtext
Only this marketplace. Leave empty for all of them.
Include buyer and addressinclude_buyer_infotrue/false
Also return the buyer's name, email and shipping address. Amazon gives them only to apps with its restricted roles.Default: false.
Maximummax_resultsnumber
Most orders to return, 1 to 500. Defaults to 100.From 1 to 500.

Outputs

countnumber
How many were returned
has_moretrue/false
True when Amazon has more than were returned; raise the maximum or narrow the search to see them
orderslist
The orders found
Example output
{
  "count": 1,
  "has_more": false,
  "orders": [
    {
      "buyer_email": "",
      "buyer_name": "",
      "created_time": "2026-10-20T10:30:00Z",
      "currency": "USD",
      "deliver_by": "2026-10-27T23:59:59Z",
      "fulfilled_by": "MERCHANT",
      "is_business_order": false,
      "is_prime": true,
      "item_count": 2,
      "items": [
        {
          "asin": "B08N5WRWNW",
          "condition": "NEW",
          "currency": "USD",
          "order_item_id": "12345678901234",
          "quantity": 2,
          "quantity_shipped": 0,
          "quantity_to_ship": 2,
          "sku": "ECHO-DOT-4-CHARCOAL",
          "title": "Echo Dot (4th Gen) | Smart speaker with Alexa | Charcoal",
          "unit_price": 49.99
        }
      ],
      "last_updated_time": "2026-10-20T14:45:00Z",
      "marketplace_id": "ATVPDKIKX0DER",
      "marketplace_name": "Amazon.com",
      "order": {
        "createdTime": "2026-10-20T10:30:00Z",
        "fulfillment": {
          "deliverByWindow": {
            "earliestDateTime": "2026-10-24T00:00:00Z",
            "latestDateTime": "2026-10-27T23:59:59Z"
          },
          "fulfilledBy": "MERCHANT",
          "fulfillmentServiceLevel": "STANDARD",
          "fulfillmentStatus": "UNSHIPPED",
          "shipByWindow": {
            "earliestDateTime": "2026-10-21T00:00:00Z",
            "latestDateTime": "2026-10-22T23:59:59Z"
          }
        },
        "lastUpdatedTime": "2026-10-20T14:45:00Z",
        "orderId": "123-4567890-1234567",
        "orderItems": [
          {
            "fulfillment": {
              "quantityFulfilled": 0,
              "quantityUnfulfilled": 2
            },
            "orderItemId": "12345678901234",
            "product": {
              "asin": "B08N5WRWNW",
              "condition": {
                "conditionType": "NEW"
              },
              "price": {
                "unitPrice": {
                  "amount": "49.99",
                  "currencyCode": "USD"
                }
              },
              "sellerSku": "ECHO-DOT-4-CHARCOAL",
              "title": "Echo Dot (4th Gen) | Smart speaker with Alexa | Charcoal"
            },
            "quantityOrdered": 2
          }
        ],
        "packages": [],
        "proceeds": {
          "grandTotal": {
            "amount": "104.98",
            "currencyCode": "USD"
          }
        },
        "programs": [
          "PRIME"
        ],
        "salesChannel": {
          "channelName": "AMAZON",
          "marketplaceId": "ATVPDKIKX0DER",
          "marketplaceName": "Amazon.com"
        }
      },
      "order_id": "123-4567890-1234567",
      "order_total": 104.98,
      "programs": [
        "PRIME"
      ],
      "service_level": "STANDARD",
      "ship_by": "2026-10-22T23:59:59Z",
      "ship_to_city": "",
      "ship_to_country": "",
      "ship_to_name": "",
      "ship_to_postal_code": "",
      "ship_to_state": "",
      "status": "UNSHIPPED",
      "tracking_numbers": []
    }
  ]
}

List reports

List reports of one type made in the last 90 days, by you or by Amazon's schedules, newest first.

Inputs

Reportreport_typetextRequired
The report, such as All listings. Pick one, or type any Amazon report type such as GET_MERCHANT_LISTINGS_ALL_DATA.
Statusesstatuseslist
Only reports in these statuses. Leave empty for all.One or more of: DONE, IN_QUEUE (Queued), IN_PROGRESS (In progress), CANCELLED (Cancelled (no data)), FATAL (Failed).
Made sincecreated_sincedate and time
Only reports made after this time. Defaults to 90 days ago.
Marketplacemarketplace_idtext
Only this marketplace. Leave empty for all of them.
Maximummax_resultsnumber
Most reports to return, 1 to 100. Defaults to 10.From 1 to 100.

Outputs

countnumber
How many were returned
has_moretrue/false
True when Amazon has more than were returned; raise the maximum or narrow the search to see them
reportslist
The reports
Example output
{
  "count": 1,
  "has_more": false,
  "reports": [
    {
      "created_time": "2026-10-12T13:47:20.677Z",
      "data_end_time": "2026-10-12T13:47:20.677Z",
      "data_start_time": "2026-10-11T13:47:20.677Z",
      "document_id": "0356cf79-b8b0-4226-b4b9-0ee058ea5760",
      "marketplace_ids": [
        "ATVPDKIKX0DER"
      ],
      "processing_end_time": "2026-10-12T13:48:20.677Z",
      "processing_start_time": "2026-10-12T13:47:25.000Z",
      "report_id": "ReportId1",
      "report_type": "GET_MERCHANT_LISTINGS_ALL_DATA",
      "status": "DONE"
    }
  ]
}

List transactions

List money in and out of your seller account (sales, refunds, fees, payouts) posted in a period, the last 7 days unless you set one, or for one order.

Inputs

Fromposted_afterdate and time
Start of the period. Defaults to 7 days ago.
Toposted_beforedate and time
End of the period, at most 180 days after the start.
Order IDorder_idtext
Only this order's transactions, whenever they posted.
Statusstatustext
Only released or deferred transactions. Leave empty for all.One of: RELEASED, DEFERRED, DEFERRED_RELEASED (Deferred, now released).
Marketplacemarketplace_idtext
Only this marketplace. Leave empty for all of them.
Maximummax_resultsnumber
Most transactions to return, 1 to 500. Defaults to 100.From 1 to 500.

Outputs

countnumber
How many were returned
has_moretrue/false
True when Amazon has more than were returned; raise the maximum or narrow the search to see them
transactionslist
The transactions
Example output
{
  "count": 1,
  "has_more": false,
  "transactions": [
    {
      "amount": 10,
      "breakdowns": [
        {
          "amount": 12,
          "type": "Sales"
        },
        {
          "amount": -2,
          "type": "Expenses"
        }
      ],
      "currency": "USD",
      "description": "Order Payment",
      "marketplace_id": "ATVPDKIKX0DER",
      "order_id": "123-4567890-1234567",
      "posted_date": "2026-10-14T03:35:13.214Z",
      "settlement_group_id": "4MVaHcsAfaYAlwlaPWrXJxrfUiKfYZ2ooWtY7528FUA",
      "status": "RELEASED",
      "transaction": {
        "breakdowns": [
          {
            "breakdownAmount": {
              "currencyAmount": 12,
              "currencyCode": "USD"
            },
            "breakdownType": "Sales"
          },
          {
            "breakdownAmount": {
              "currencyAmount": -2,
              "currencyCode": "USD"
            },
            "breakdownType": "Expenses"
          }
        ],
        "description": "Order Payment",
        "postedDate": "2026-10-14T03:35:13.214Z",
        "relatedIdentifiers": [
          {
            "relatedIdentifierName": "FINANCIAL_EVENT_GROUP_ID",
            "relatedIdentifierValue": "4MVaHcsAfaYAlwlaPWrXJxrfUiKfYZ2ooWtY7528FUA"
          },
          {
            "relatedIdentifierName": "ORDER_ID",
            "relatedIdentifierValue": "123-4567890-1234567"
          }
        ],
        "sellingPartnerMetadata": {
          "accountType": "PAYABLE",
          "marketplaceId": "ATVPDKIKX0DER",
          "sellingPartnerId": "A3TH9S8BH6GOGM"
        },
        "totalAmount": {
          "currencyAmount": 10,
          "currencyCode": "USD"
        },
        "transactionId": "txn-0001",
        "transactionStatus": "RELEASED",
        "transactionType": "Shipment"
      },
      "transaction_id": "txn-0001",
      "type": "Shipment"
    }
  ]
}

Request a review

Have Amazon email the buyer its standard request for a product review and seller feedback. Amazon allows it once per order, 5 to 30 days after delivery; the step checks that first and can stop there.

Inputs

Order IDorder_idtextRequired
Amazon's order ID, like 123-1234567-1234567, from 'List orders', a trigger or Seller Central.
Only checkcheck_onlytrue/false
Only find out whether a request can be sent now.Default: false.
Marketplacemarketplace_idtext
The order's marketplace. Leave empty to read it from the order.

Outputs

eligibletrue/false
Whether Amazon allows a review request now
messagetext
What happened, in words
order_idtext
The order
senttrue/false
Whether the request was sent
Example output
{
  "eligible": true,
  "message": "Amazon is sending the buyer its review and feedback request.",
  "order_id": "123-4567890-1234567",
  "sent": true
}

Search catalog

Search Amazon's catalog by keywords, or look products up by codes such as UPC, EAN or ASIN, with title, brand, image and sales rank.

Inputs

Keywordskeywordstext
Words to search for. Give these or codes, not both.
Codesidentifierslist
Up to 20 product codes to look up, of the kind chosen.
Code typeidentifier_typetext
What kind of codes they are. Defaults to ASIN.One of: ASIN, EAN, UPC, ISBN, GTIN, JAN, SKU (Your SKU). Default: ASIN.
Brandbrandtext
Only this brand, for a keyword search.
Marketplacemarketplace_idtext
The marketplace, such as Amazon.com. Leave empty for your main marketplace in the connection's region.
Maximummax_resultsnumber
Most products to return, 1 to 100. Defaults to 20.From 1 to 100.

Outputs

countnumber
How many were returned
has_moretrue/false
True when Amazon has more than were returned; raise the maximum or narrow the search to see them
itemslist
The products found
Example output
{
  "count": 1,
  "has_more": false,
  "items": [
    {
      "asin": "B07N4M94X4",
      "brand": "SAMSUNG",
      "category": "QLED TVs",
      "color": "Black",
      "identifiers": [
        {
          "type": "UPC",
          "value": "887276302195"
        }
      ],
      "image_url": "https://m.media-amazon.com/images/I/51DZzp3w3vL.jpg",
      "item_classification": "BASE_PRODUCT",
      "manufacturer": "Samsung",
      "model_number": "QN82Q60RAFXZA",
      "product_type": "TELEVISION",
      "sales_rank": 72855,
      "sales_rank_category": "Electronics",
      "size": "82-Inch",
      "title": "Samsung QN82Q60RAFXZA Flat 82-Inch QLED 4K Q60 Series"
    }
  ]
}

Update price and quantity

Change a listing's price, the quantity you have to ship, or both. Quantity is for listings you fulfil; Amazon counts FBA stock itself.

Inputs

SKUskutextRequired
Your SKU for the listing, from 'List listings' or Seller Central.
Pricepricenumber
The new price in the marketplace's currency, such as 19.99. Leave empty to keep it.At least 0.01.
Quantityquantitynumber
How many you have to ship. Leave empty to keep it.At least 0.
Modemodetext
Save the change, or only have Amazon check it and report problems without changing anything.One of: save (Save the change), check (Only check it (nothing changes)). Default: save.
Marketplacemarketplace_idtext
The marketplace, such as Amazon.com. Leave empty for your main marketplace in the connection's region.

Outputs

resultobject
What Amazon made of it
Example output
{
  "result": {
    "asin": "B071VG5N9D",
    "checked_only": true,
    "has_errors": false,
    "issues": [],
    "sku": "GM-ZDPI-9B4E",
    "status": "VALID",
    "submission_id": "f1dc2914-75dd-11ea-bc55-0242ac130003"
  }
}

On this page