FBA Inbound Eligibility API v1 reference

Let sellers get eligibility previews for items before shipping them to Amazon's fulfillment centers.

Overview

With the FBA Inbound Eligibility API, you can build applications that let sellers get eligibility previews for items before shipping them to Amazon's fulfillment centers. With this API you can find out if an item is eligible for inbound shipment to Amazon's fulfillment centers in a specific marketplace. You can also find out if an item is eligible for using the manufacturer barcode for FBA inventory tracking. Sellers can use this information to inform their decisions about which items to ship Amazon's fulfillment centers.

Version information

Version : v1

Contact information

Contact : Selling Partner API Developer Support
Contact URL : https://sellercentral.amazon.com/gp/mws/contactus.html

License information

License : Apache License 2.0
License URL : http://www.apache.org/licenses/LICENSE-2.0

URI scheme

Host : sellingpartnerapi-na.amazon.com
Schemes : HTTPS

Consumes

  • application/json

Produces

  • application/json

Operations

getItemEligibilityPreview

Paths

GET /fba/inbound/v1/eligibility/itemPreview

Operation: getItemEligibilityPreview

Description

This operation gets an eligibility preview for an item that you specify. You can specify the type of eligibility preview that you want (INBOUND or COMMINGLING). For INBOUND previews, you can specify the marketplace in which you want to determine the item's eligibility.

Usage Plan:

Rate (requests per second)Burst
11

For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.

Parameters

TypeNameDescriptionSchema
QuerymarketplaceIds
optional
The identifier for the marketplace in which you want to determine eligibility. Required only when program=INBOUND.
Max count : 1
< string > array
Queryasin
required
The ASIN of the item for which you want an eligibility preview.string
Queryprogram
required
The program that you want to check eligibility against.enum (Program)

Responses

HTTP CodeDescriptionSchema
200Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference ID.
GetItemEligibilityPreviewResponse

For error status codes, descriptions and schemas, see Error responses and schemas.

Error Responses and Schemas

This table contains HTTP status codes and associated information for error responses.

HTTP CodeDescriptionSchema
400Request has missing or invalid parameters and cannot be parsed.
Headers:
x-amzn-RateLimit-Limit (string):Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string):Unique request reference ID.
GetItemEligibilityPreviewResponse
401The request's Authorization header is not formatted correctly or does not contain a valid token.
Headers:
x-amzn-RateLimit-Limit (string):Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string):Unique request reference ID.
GetItemEligibilityPreviewResponse
403403 can be caused for reasons like Access Denied, Unauthorized, Expired Token, Invalid Signature or Resource Not Found.
Headers:
x-amzn-RequestId (string):Unique request reference ID.
GetItemEligibilityPreviewResponse
404The resource specified does not exist.
Headers:
x-amzn-RateLimit-Limit (string):Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string):Unique request reference ID.
GetItemEligibilityPreviewResponse
429The frequency of requests was greater than allowed.
Headers:
x-amzn-RateLimit-Limit (string):Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string):Unique request reference ID.
GetItemEligibilityPreviewResponse
500Encountered an unexpected condition which prevented the server from fulfilling the request.
Headers:
x-amzn-RateLimit-Limit (string):Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string):Unique request reference ID.
GetItemEligibilityPreviewResponse
503Temporary overloading or maintenance of the server.
Headers:
x-amzn-RateLimit-Limit (string):Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string):Unique request reference ID.
GetItemEligibilityPreviewResponse

Definitions

GetItemEligibilityPreviewResponse

The response schema for the getItemEligibilityPreview operation.

NameDescriptionSchema
payload
optional
The payload for the getItemEligibilityPreview operation.ItemEligibilityPreview
errors
optional
An unexpected condition occurred during the GetItemEligibilityPreview operation.ErrorList

ItemEligibilityPreview

The response object which contains the ASIN, marketplaceId if required, eligibility program, the eligibility status (boolean), and a list of ineligibility reason codes.

NameDescriptionSchema
asin
required
The ASIN for which eligibility was determined.string
marketplaceId
optional
The marketplace for which eligibility was determined.string
program
required
The program for which eligibility was determined.enum (Program)
isEligibleForProgram
required
Indicates if the item is eligible for the program.boolean
ineligibilityReasonList
optional
Potential Ineligibility Reason Codes.< enum (IneligibilityReasonList) > array

ErrorList

A list of error responses returned when a request is unsuccessful.

Type : < Error > array

Error

Error response returned when the request is unsuccessful.

NameDescriptionSchema
code
required
An error code that identifies the type of error that occurred.string
message
optional
A message that describes the error condition in a human-readable form.string
details
optional
Additional information that can help the caller understand or fix the issue.string

IneligibilityReasonList

Potential Ineligibility Reason Codes.

Type : enum

ValueDescription
FBA_INB_0004Missing package dimensions. This product is missing necessary information; dimensions need to be provided in the manufacturer's original packaging.
FBA_INB_0006The SKU for this product is unknown or cannot be found.
FBA_INB_0007Product Under Dangerous Goods (Hazmat) Review. We do not have enough information to determine what the product is or comes with to enable us to complete our dangerous goods review. Until you provide the necessary information, the products will not be available for sale and you will not be able to send more units to Amazon fulfillment centers. You will need to add more details to the product listings, such as a clear title, bullet points, description, and image. The review process takes 4 business days.
FBA_INB_0008Product Under Dangerous Goods (Hazmat) Review. We require detailed battery information to correctly classify the product, and until you provide the necessary information, the products will not be available for sale and you will not be able to send more units to Amazon fulfillment centers. Download an exemption sheet for battery and battery-powered products available in multiple languages in "Upload dangerous goods documents: safety data sheet (SDS) or exemption sheet" in Seller Central and follow instructions to submit it through the same page. The review process takes 4 business days.
FBA_INB_0009Product Under Dangerous Goods (Hazmat) Review. We do not have enough dangerous goods information to correctly classify the product and until you provide the necessary information, the products will not be available for sale and you will not be able to send more units to Amazon fulfillment centers. Please provide a Safety Data Sheet (SDS) through "Upload dangerous goods documents: safety data sheet (SDS) or exemption sheet" in Seller Central, and make sure the SDS complies with all the requirements. The review process takes 4 business days.
FBA_INB_0010Product Under Dangerous Goods (Hazmat) Review. The dangerous goods information is mismatched and so the product cannot be correctly classified. Until you provide the necessary information, the products will not be available for sale and you will not be able to send more units to Amazon fulfillment centers. Please provide compliant documents through "Upload dangerous goods documents: safety data sheet (SDS) or exemption sheet" in Seller Central, and make sure it complies with all the requirements. The review process takes 4 business days, the product will remain unfulfillable until review process is complete.
FBA_INB_0011Product Under Dangerous Goods (Hazmat) Review. We have incomplete, inaccurate or conflicting dangerous goods information and cannot correctly classify the product. Until you provide the necessary information, the products will not be available for sale and you will not be able to send more units to Amazon fulfillment centers. Please provide compliant documents through "Upload dangerous goods documents: safety data sheet (SDS) or exemption sheet" in Seller Central, and make sure it complies with all the requirements. The review process takes 4 business days and the product will remain unfulfillable until the review process is complete.
FBA_INB_0012Product Under Dangerous Goods (Hazmat) Review. We have determined there is conflicting product information (title, bullet points, images, or product description) within the product detail pages or with other offers for the product. Until the conflicting information is corrected, the products will not be available for sale and you will not be able to send more units to Amazon fulfillment centers. We need you to confirm the information on the product detail page The review process takes 4 business days.
FBA_INB_0013Product Under Dangerous Goods (Hazmat) Review. Additional information is required in order to complete the Hazmat review process.
FBA_INB_0014Product Under Dangerous Goods (Hazmat) Review. The product has been identified as possible dangerous goods. The review process generally takes 4 - 7 business days and until the review process is complete the product is unfulfillable and cannot be received at Amazon fulfilment centers or ordered by customers. For more information about dangerous goods please see "Dangerous goods identification guide (hazmat)"" help page in Seller Central.
FBA_INB_0015Dangerous goods (Hazmat). The product is regulated as unfulfillable and not eligible for sale with Amazon. We ask that you refrain from sending additional units in new shipments. We will need to dispose of your dangerous goods inventory in accordance with the terms of the Amazon Business Services Agreement. If you have questions or concerns, please contact Seller Support within five business days of this notice. For more information about dangerous goods please see “Dangerous goods identification guide (hazmat)” help page in Seller Central.
FBA_INB_0016Dangerous goods (Hazmat). The product is regulated as a fulfillable dangerous good (Hazmat). You may need to be in the FBA dangerous good (Hazmat) program to be able to sell your product. For more information on the FBA dangerous good (Hazmat) program please contact Seller Support. For more information about dangerous goods please see the "Dangerous goods identification guide (hazmat)" help page in Seller Central.
FBA_INB_0017This product does not exist in the destination marketplace catalog. The necessary product information will need to be provided before it can be inbounded.
FBA_INB_0018Product missing category. This product must have a category specified before it can be sent to Amazon.
FBA_INB_0019This product must have a title before it can be sent to Amazon.
FBA_INB_0034Product cannot be stickerless, commingled. This product must be removed. You can send in new inventory by creating a new listing for this product that requires product labels.
FBA_INB_0035Expiration-dated/lot-controlled product needs to be labeled. This product requires labeling to be received at our fulfillment centers.
FBA_INB_0036Expiration-dated or lot-controlled product needs to be commingled. This product cannot be shipped to Amazon without being commingled. This error condition cannot be corrected from here. This product must be removed.
FBA_INB_0037This product is not eligible to be shipped to our fulfillment center. You do not have all the required tax documents. If you have already filed documents please wait up to 48 hours for the data to propagate.
FBA_INB_0038Parent ASIN cannot be fulfilled by Amazon. You can send this product by creating a listing against the child ASIN.
FBA_INB_0050There is currently no fulfillment center in the destination country capable of receiving this product. Please delete this product from the shipment or contact Seller Support if you believe this is an error.
FBA_INB_0051This product has been blocked by FBA and cannot currently be sent to Amazon for fulfillment.
FBA_INB_0053Product is not eligible in the destination marketplace. This product is not eligible either because the required shipping option is not available or because the product is too large or too heavy.
FBA_INB_0055Product unfulfillable due to media region restrictions. This product has a region code restricted for this marketplace. This product must be removed.
FBA_INB_0056Product is ineligible for inbound. Used non-media goods cannot be shipped to Amazon.
FBA_INB_0059Unknown Exception. This product must be removed at this time.
FBA_INB_0065Product cannot be stickerless, commingled. This product must be removed. You can send in new inventory by creating a new listing for this product that requires product labels.
FBA_INB_0066Unknown Exception. This product must be removed at this time.
FBA_INB_0067Product ineligible for freight shipping. This item is ineligible for freight shipping with our Global Shipping Service. This item must be removed.
FBA_INB_0068Account not configured for expiration-dated or lot-controlled products. Please contact TAM if you would like to configure your account to handle expiration-dated or lot-controlled inventory. Once configured, you will be able to send in this product.
FBA_INB_0095The barcode (UPC/EAN/JAN/ISBN) for this product is associated with more than one product in our fulfillment system. This product must be removed. You can send in new inventory by creating a new listing for this product that requires product labels.
FBA_INB_0097Fully regulated dangerous good.
FBA_INB_0098Merchant is not authorized to send item to destination marketplace.
FBA_INB_0099Seller account previously terminated.
FBA_INB_0100You do not have the required tax information to send inventory to fulfillment centers in Mexico.
FBA_INB_0103This is an expiration-dated/lot-controlled product that cannot be handled at this time.
FBA_INB_0104Item Requires Manufacturer Barcode. Only NEW products can be stored in our fulfillment centers without product labels.
FBA_INB_0197Item requires safety and compliance documentation. Orders for this product cannot be fulfilled by FBA without required safety and compliance documentation.
UNKNOWN_INB_ERROR_CODEUnknown Ineligibility Reason.

Program

Type : enum

For use with the definition(s): ItemEligibilityPreview
The program for which eligibility was determined.

ValueDescription
INBOUNDInbound shipment.
COMMINGLINGUsing the manufacturer barcode for FBA inventory tracking.

For use with the operation(s): getItemEligibilityPreview
The program that you want to check eligibility against.

ValueDescription
INBOUND-
COMMINGLING-