Skip to main content

Check FBA eligibility and listing restrictions

These read Actions are available for Seller Central accounts. Enable each Action in Settings > Actions (opens in a new tab). They use the seller, marketplace and region of sellerOrVendorId and do not require personal data access.

Call these checks explicitly before planning inbound shipments or listing changes. They do not enroll products, create offers, approve products or create shipments. Listing VERIFY Actions check a proposed listing payload separately.

Each Action accepts 1 to 100 queries through the REST API or 1 to 20 through MCP. Each query counts as one item under the standard read Action price. dryRun validates the request without making these eligibility calls.

Action typeDescriptionMax. queries, API/MCP
AMAZON_FBA_ELIGIBILITY_FIND
(R, Sellers only)
Check one ASIN and program per query.100/20
AMAZON_LISTINGS_RESTRICTIONS_FIND
(R, Sellers only)
Check restrictions for one ASIN, optionally filtered by condition and product type.100/20

Check FBA eligibility

Use AMAZON_FBA_ELIGIBILITY_FIND with:

json
1{
2    "eligibilityQueries": [
3        { "asin": "B000000001", "program": "INBOUND" },
4        { "asin": "B000000001", "program": "COMMINGLING" }
5    ]
6}

INBOUND checks the connected marketplace. COMMINGLING omits the marketplace in the Amazon request. Its response may omit a marketplace too. The requested marketplace in the result records your DataDoe context and does not mean Amazon evaluated COMMINGLING for that marketplace.

Each successful result contains isEligibleForProgram and ineligibilityReasonCodes. Unknown codes are preserved. A failed check has status: "ERROR", structured errors and no eligibility value.

Check listing restrictions

Use AMAZON_LISTINGS_RESTRICTIONS_FIND with:

json
1{
2    "restrictionQueries": [{ "asin": "B000000001" }]
3}

Omit conditionType to check all applicable conditions. You can also set conditionType, reasonLocale and productType. Omit reasonLocale to use Amazon's default. A successful result contains restrictions, restrictionCount and hasRestrictions. Reasons retain Amazon's messages and full approval links. DataDoe returns these links as data and does not open them.

An empty successful array means Amazon returned no restrictions for that exact query. It does not guarantee listing acceptance or FBA eligibility. A failed check has no hasRestrictions value.

Read the results

Results preserve query order in response.checks, with separate indexed response.success and response.error lists. Each check includes its checkId, UTC checkedAt, ASIN, requested marketplace, status and Amazon request ID when available. Repeating an ASIN creates another explicit check.

These are observations at a point in time. Action results stay in Action history. A missing Amazon role returns an error. Restore that role or reconnect the account before you try again.