---
title: "batchInventory"
method: POST
path: "/externalFulfillment/inventory/2024-09-11/inventories"
tags: ["External Fulfillment Inventory v2024-09-11"]
---

# batchInventory

`POST /externalFulfillment/inventory/2024-09-11/inventories`

Make up to 10 inventory requests. The response includes the set of responses that correspond to requests. The response for each successful request in the set includes the  inventory count for the provided `sku` and `locationId` pair.

## Request body

- BatchInventoryRequest — A list of inventory requests.
  - `requests` InventoryRequest[] — A list of inventory requests.
    - `uri` string, required — The URI associated with the individual APIs from the batch request. The user must provide the resource identifier for the operation they want to use.
    - `method` 'GET' | 'PUT' | 'PATCH' | 'DELETE' | 'POST', required — The HTTP method associated with an individual request within a batch.
    - `body` InventoryRequestParams — The parameters for an individual request.
      - `clientSequenceNumber` integer — The latest sequence number for the inventory update operation. You find this value in the `clientSequenceNumber` property in the response to the `batchInventory` operation.
      - `quantity` integer — The absolute inventory quantity.
      - `marketplaceAttributes` MarketplaceAttributes — The marketplace attributes associated with the location.
        - `marketplaceId` string, required — The marketplace ID associated with the location. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).
        - `channelName` string, required — The channel name associated with the location.
        - `merchantId` string — The ID of the merchant or seller to whom this order is created.
        - `customAttributes` string[] — Marketplace channel-specific attribute value.

## Response `207`

Multi-status response that contains information about numerous resources.

- BatchInventoryResponse — The response of the `batchInventory` operation.
  - `responses` InventoryResponse[] — A list of inventory request responses.
    - `status` HttpStatusLine, required — The HTTP status line associated with the response for an individual request within a batch. For more information, refer to [RFC 2616](https://www.w3.org/Protocols/rfc2616/rfc2616-sec6.html).
      - `statusCode` integer — The HTTP response status code.
      - `reasonPhrase` string — The HTTP response reason phrase.
    - `body` InventoryResponseBody, required — The response to an inventory request.
      - `clientSequenceNumber` integer — Latest sequence number for an inventory update.
      - `locationId` string — The location where inventory is updated or retrieved.
      - `skuId` string — The SKU ID for which inventory is updated or retrieved
      - `sellableQuantity` integer — The number of items of the specified SKU that are available for purchase.
      - `reservedQuantity` integer — The number of items of the specified SKU created in any marketplace that are reserved for shipment and yet to be fulfilled.
      - `marketplaceAttributes` MarketplaceAttributes — The marketplace attributes associated with the location.
        - `marketplaceId` string, required — The marketplace ID associated with the location. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).
        - `channelName` string, required — The channel name associated with the location.
        - `merchantId` string — The ID of the merchant or seller to whom this order is created.
        - `customAttributes` string[] — Marketplace channel-specific attribute value.
      - `actionableErrors` ActionableError[] — Inventory operation errors that require seller action before retrying the inventory request.
        - `errorType` string — The top level error type that may contain multiple error subtypes.
        - `errorSubType` string — The secondary level error type.

## Other responses

- `400` — Request has missing or invalid parameters and cannot be parsed.
- `401` — The request's Authorization header is not formatted correctly or does not contain a valid token.
- `403` — Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
- `404` — The resource specified does not exist.
- `413` — The request size exceeded the maximum accepted size.
- `415` — The request payload is in an unsupported format.
- `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)