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
| Action | What it does |
|---|---|
| Confirm shipment | Tell Amazon an order you fulfil has shipped, with the carrier and tracking number. |
| 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. |
| Create report | Ask Amazon to build a report, such as all orders or all listings, for a period. |
| Delete listing | Delete your listing for a SKU from a marketplace. |
| 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. |
| Estimate fees | Estimate Amazon's fees (referral, FBA and the rest) for selling a product at a price, and what you would keep. |
| Get balances | Get your seller account's balances now: the total, what is available to pay out, and what Amazon is holding back. |
| Get catalog item | Get a product from Amazon's catalog by ASIN: title, brand, product type, image, codes, sales rank and its full attributes. |
| 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. |
| Get financial summary | Get what you made over a period after Amazon's fees, broken down into sales, refunds, fees and the rest. |
| Get listing | Get one listing by SKU with its status, price, quantity, issues and all its attributes. |
| Get offers | Get the lowest offers on a product, who holds the Buy Box and at what price, by ASIN or your SKU. |
| Get order | Get one order with its items, totals, ship-by date, packages and tracking numbers. |
| Get report | Get a report's status, and whether it is ready to download. |
| List FBA inventory | List the stock Amazon holds for you (FBA) per SKU: ready to ship, on its way in, reserved and unsellable. |
| List listings | List your listings with their title, price, quantity, buyable status and any errors, most recently changed first. |
| List marketplaces | List the Amazon marketplaces your account sells in, with each one's ID, currency and website. |
| 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. |
| List reports | List reports of one type made in the last 90 days, by you or by Amazon's schedules, newest first. |
| 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. |
| Request a review | Have Amazon email the buyer its standard request for a product review and seller feedback. |
| 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. |
| Update price and quantity | Change 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 ID
order_idtextRequired - Amazon's order ID, like 123-1234567-1234567, from 'List orders', a trigger or Seller Central.
- Carrier
carriertextRequired - 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 number
tracking_numbertextRequired - The package's tracking number.
- Carrier name
carrier_nametext - The carrier's name, needed when the carrier is Other.
- Shipping service
shipping_methodtext - The service used, such as Priority Mail.
- Shipped at
ship_datedate and time - When the package shipped. Defaults to now.
- Only these items
order_item_idslist - The order_item_id of each item in this package, from 'Get order'. Leave empty to ship everything still to ship.
- Package number
package_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
- SKU
skutextRequired - Your SKU for the listing, from 'List listings' or Seller Central.
- Product type
product_typetextRequired - Amazon's product type, such as LUGGAGE or SHIRT. 'Get catalog item' shows a product's type.
- Attributes
attributesobjectRequired - 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 kind
requirementstext - 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. - Mode
modetext - 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. - Marketplace
marketplace_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
- Report
report_typetextRequired - The report, such as All listings. Pick one, or type any Amazon report type such as GET_MERCHANT_LISTINGS_ALL_DATA.
- From
start_timedate and time - Start of the period it covers, for reports that take one.
- To
end_timedate and time - End of the period it covers.
- Marketplace
marketplace_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
- SKU
skutextRequired - Your SKU for the listing, from 'List listings' or Seller Central.
- Marketplace
marketplace_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 ID
report_idtextRequired - The report's ID, from 'Create report' or 'List reports'.
- Maximum rows
max_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
- Product
identifiertextRequired - The ASIN, or your SKU if you look up by SKU.
- Price
pricenumberRequired - The selling price in the marketplace's currency, such as 19.99.At least 0.
- Look up by
identifier_typetext - Whether the product is given by ASIN or by your SKU.One of:
ASIN,SKU(Your SKU). Default:ASIN. - Shipping charge
shippingnumber - What the buyer pays for shipping. Defaults to 0.At least 0.
- Fulfilled by Amazon
fulfilled_by_amazontrue/false - Include FBA fees, for a product Amazon ships.Default:
false. - Marketplace
marketplace_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
- Marketplace
marketplace_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
- ASIN
asintextRequired - The product's ASIN, such as B08N5WRWNW.
- Marketplace
marketplace_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
- Products
identifierslistRequired - Up to 20 ASINs, or SKUs if you look up by SKU.
- Look up by
identifier_typetext - Whether the product is given by ASIN or by your SKU.One of:
ASIN,SKU(Your SKU). Default:ASIN. - Prices for
customer_typetext - Prices consumers see, or business buyers. Defaults to consumers.One of:
Consumer(Consumers),Business(Business buyers). - Marketplace
marketplace_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
- From
start_datedate - First day of the period.
- To
end_datedate - Last day of the period.
- Marketplace
marketplace_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
- SKU
skutextRequired - Your SKU for the listing, from 'List listings' or Seller Central.
- Marketplace
marketplace_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
- Product
identifiertextRequired - The ASIN, or your SKU if you look up by SKU.
- Look up by
identifier_typetext - Whether the product is given by ASIN or by your SKU.One of:
ASIN,SKU(Your SKU). Default:ASIN. - Condition
conditiontext - Offers in this condition. Defaults to new.One of:
New,Used,Collectible,Refurbished,Club. Default:New. - Prices for
customer_typetext - Prices consumers see, or business buyers. Defaults to consumers.One of:
Consumer(Consumers),Business(Business buyers). - Marketplace
marketplace_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 ID
order_idtextRequired - Amazon's order ID, like 123-1234567-1234567, from 'List orders', a trigger or Seller Central.
- Include buyer and address
include_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 ID
report_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
- Marketplace
marketplace_idtext - The marketplace, such as Amazon.com. Leave empty for your main marketplace in the connection's region.
- SKUs
skuslist - Only these SKUs, up to 50. Leave empty for all.
- Changed since
changed_sincedate and time - Only SKUs whose stock changed after this time.
- Maximum
max_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
- Marketplace
marketplace_idtext - The marketplace, such as Amazon.com. Leave empty for your main marketplace in the connection's region.
- Show
showtext - 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. - SKUs
skuslist - Only these SKUs, up to 20. Leave empty for all.
- Changed since
changed_sincedate and time - Only listings changed after this time.
- Order
sort_bytext - How to sort them. Defaults to recently changed first.One of:
lastUpdatedDate(Recently changed first),createdDate(Newest first),sku(By SKU). Default:lastUpdatedDate. - Maximum
max_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 orders
date_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. - From
from_timedate and time - Start of the period. Defaults to 7 days ago.
- To
to_timedate and time - End of the period. Defaults to now.
- Statuses
statuseslist - 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 by
fulfilled_bytext - Only orders you ship, or only orders Amazon ships (FBA).One of:
MERCHANT(You (merchant fulfilled)),AMAZON(Amazon (FBA)). - Marketplace
marketplace_idtext - Only this marketplace. Leave empty for all of them.
- Include buyer and address
include_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. - Maximum
max_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
- Report
report_typetextRequired - The report, such as All listings. Pick one, or type any Amazon report type such as GET_MERCHANT_LISTINGS_ALL_DATA.
- Statuses
statuseslist - 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 since
created_sincedate and time - Only reports made after this time. Defaults to 90 days ago.
- Marketplace
marketplace_idtext - Only this marketplace. Leave empty for all of them.
- Maximum
max_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
- From
posted_afterdate and time - Start of the period. Defaults to 7 days ago.
- To
posted_beforedate and time - End of the period, at most 180 days after the start.
- Order ID
order_idtext - Only this order's transactions, whenever they posted.
- Status
statustext - Only released or deferred transactions. Leave empty for all.One of:
RELEASED,DEFERRED,DEFERRED_RELEASED(Deferred, now released). - Marketplace
marketplace_idtext - Only this marketplace. Leave empty for all of them.
- Maximum
max_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 ID
order_idtextRequired - Amazon's order ID, like 123-1234567-1234567, from 'List orders', a trigger or Seller Central.
- Only check
check_onlytrue/false - Only find out whether a request can be sent now.Default:
false. - Marketplace
marketplace_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
- Keywords
keywordstext - Words to search for. Give these or codes, not both.
- Codes
identifierslist - Up to 20 product codes to look up, of the kind chosen.
- Code type
identifier_typetext - What kind of codes they are. Defaults to ASIN.One of:
ASIN,EAN,UPC,ISBN,GTIN,JAN,SKU(Your SKU). Default:ASIN. - Brand
brandtext - Only this brand, for a keyword search.
- Marketplace
marketplace_idtext - The marketplace, such as Amazon.com. Leave empty for your main marketplace in the connection's region.
- Maximum
max_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
- SKU
skutextRequired - Your SKU for the listing, from 'List listings' or Seller Central.
- Price
pricenumber - The new price in the marketplace's currency, such as 19.99. Leave empty to keep it.At least 0.01.
- Quantity
quantitynumber - How many you have to ship. Leave empty to keep it.At least 0.
- Mode
modetext - 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. - Marketplace
marketplace_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"
}
}