--- title: "getInventorySummaries" method: GET path: "/fba/inventory/v1/summaries" tags: ["FBA Inventory v1"] --- # getInventorySummaries `GET /fba/inventory/v1/summaries` Returns a list of inventory summaries. The summaries returned depend on the presence or absence of the startDateTime, sellerSkus and sellerSku parameters: - All inventory summaries with available details are returned when the startDateTime, sellerSkus and sellerSku parameters are omitted. - When startDateTime is provided, the operation returns inventory summaries that have had changes after the date and time specified. The sellerSkus and sellerSku parameters are ignored. Important: To avoid errors, use both startDateTime and nextToken to get the next page of inventory summaries that have changed after the date and time specified. - When the sellerSkus parameter is provided, the operation returns inventory summaries for only the specified sellerSkus. The sellerSku parameter is ignored. - When the sellerSku parameter is provided, the operation returns inventory summaries for only the specified sellerSku. Note: The parameters associated with this operation may contain special characters that must be encoded to successfully call the API. To avoid errors with SKUs when encoding URLs, refer to [URL Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding). Usage Plan: | Rate (requests per second) | Burst | | ---- | ---- | | 2 | 2 | The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits). ## Query parameters - `details` boolean - `granularityType` 'Marketplace', required - `granularityId` string, required - `startDateTime` string, date-time - `sellerSkus` string[] - `sellerSku` string - `nextToken` string - `marketplaceIds` string[], required ## Response `200` OK - GetInventorySummariesResponse — The Response schema. - `payload` GetInventorySummariesResult — The payload schema for the getInventorySummaries operation. - `granularity` Granularity, required — Describes a granularity at which inventory data can be aggregated. For example, if you use Marketplace granularity, the fulfillable quantity will reflect inventory that could be fulfilled in the given marketplace. - `granularityType` string — The granularity type for the inventory aggregation level. - `granularityId` string — The granularity ID for the specified granularity type. When granularityType is Marketplace, specify the marketplaceId. - `inventorySummaries` InventorySummary[], required — A list of inventory summaries. - `asin` string — The Amazon Standard Identification Number (ASIN) of an item. - `fnSku` string — Amazon's fulfillment network SKU identifier. - `sellerSku` string — The seller SKU of the item. - `condition` string — The condition of the item as described by the seller (for example, New Item). - `inventoryDetails` InventoryDetails — Summarized inventory details. This object will not appear if the details parameter in the request is false. - `fulfillableQuantity` integer — The item quantity that can be picked, packed, and shipped. - `inboundWorkingQuantity` integer — The number of units in an inbound shipment for which you have notified Amazon. - `inboundShippedQuantity` integer — The number of units in an inbound shipment that you have notified Amazon about and have provided a tracking number. - `inboundReceivingQuantity` integer — The number of units that have not yet been received at an Amazon fulfillment center for processing, but are part of an inbound shipment with some units that have already been received and processed. - `reservedQuantity` ReservedQuantity — The quantity of reserved inventory. - `totalReservedQuantity` integer — The total number of units in Amazon's fulfillment network that are currently being picked, packed, and shipped; or are sidelined for measurement, sampling, or other internal processes. - `pendingCustomerOrderQuantity` integer — The number of units reserved for customer orders. - `pendingTransshipmentQuantity` integer — The number of units being transferred from one fulfillment center to another. - `fcProcessingQuantity` integer — The number of units that have been sidelined at the fulfillment center for additional processing. - `researchingQuantity` ResearchingQuantity — The number of misplaced or warehouse damaged units that are actively being confirmed at our fulfillment centers. - `totalResearchingQuantity` integer — The total number of units currently being researched in Amazon's fulfillment network. - `researchingQuantityBreakdown` ResearchingQuantityEntry[] — A list of quantity details for items currently being researched. - `name` 'researchingQuantityInShortTerm' | 'researchingQuantityInMidTerm' | 'researchingQuantityInLongTerm', required — The duration of the research. - `quantity` integer, required — The number of units. - `unfulfillableQuantity` UnfulfillableQuantity — The quantity of unfulfillable inventory. - `totalUnfulfillableQuantity` integer — The total number of units in Amazon's fulfillment network in unsellable condition. - `customerDamagedQuantity` integer — The number of units in customer damaged disposition. - `warehouseDamagedQuantity` integer — The number of units in warehouse damaged disposition. - `distributorDamagedQuantity` integer — The number of units in distributor damaged disposition. - `carrierDamagedQuantity` integer — The number of units in carrier damaged disposition. - `defectiveQuantity` integer — The number of units in defective disposition. - `expiredQuantity` integer — The number of units in expired disposition. - `lastUpdatedTime` string, date-time — The date and time that any quantity was last updated. - `productName` string — The localized language product title of the item within the specific marketplace. - `totalQuantity` integer — The total number of units in an inbound shipment or in Amazon fulfillment centers. - `stores` string[] — A list of seller-enrolled stores that apply to this seller SKU. - `pagination` Pagination — The pagination elements required to retrieve the remaining data. - `nextToken` string — A generated string used to pass information to your next request. If NextToken is returned, pass the value of NextToken to the next request. If NextToken is not returned, there are no more shipment items to return. - `errors` Error[] — A list of error responses returned when a request is unsuccessful. - `code` string, required — An error code that identifies the type of error that occurred. - `message` string, required — A message that describes the error condition. - `details` string — Additional details that can help the caller understand or fix the issue. ## Other responses - `400` — Request has missing or invalid parameters and cannot be parsed. - `403` — Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, Invalid Signature or Resource Not Found. - `404` — The specified resource does not exist. - `429` — The frequency of requests was greater than allowed. - `500` — An unexpected condition occurred that prevented the server from fulfilling the request. - `503` — Temporary overloading or maintenance of the server. --- [API](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01.md) · [All operations](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws-samples/a-content-management-v2020-11-01/revisions/815a5b6dbaa6/schema)