---
title: "Look up live warehouse inventory for a batch of Chewy products"
method: GET
path: "/chewy/inventory"
tags: ["Chewy"]
---

# Look up live warehouse inventory for a batch of Chewy products

`GET /chewy/inventory`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/chewy/inventory`
- Auth: API key in header `x-api-key`

Returns Chewy's live warehouse inventory position for up to 20 products in one call, keyed by part number: the availability status, total units on hand, units inbound/in progress, units already reserved against unshipped orders, and the quantity actually available to the storefront. This is the only Chewy surface that carries real quantities -- every other endpoint in this family reports stock as a single boolean, so "36 units left" and "84,386 units left" are indistinguishable there. Quantities are live and move between calls. Part numbers Chewy does not return inventory for are reported in not_found; if none resolve the response is a 404.

## Query parameters

- `part_numbers` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- ChewyInventoryResponseDoc
  - `code` integer
  - `data` ChewyInventoryResponse
    - `count` integer
    - `fetched_at` string
    - `items` ChewyItemInventory[]
      - `available_date` string: AvailableDate is upstream's own as-of timestamp for this reading.
      - `is_freezer_item` boolean
      - `part_number` string
      - `quantity_available_to_site` integer: QuantityAvailableToSite is what the storefront may actually sell -- typically far below quantity_on_hand, and the figure that governs whether a product reads as in stock.
      - `quantity_in_progress` integer: QuantityInProgress is inbound/being-processed units not yet on hand.
      - `quantity_on_hand` integer: QuantityOnHand is total units physically in Chewy's warehouses.
      - `quantity_reserved` integer: QuantityReserved is units already committed to unshipped orders.
      - `status` string: Status is Chewy's own availability enum: AVAILABLE, OUT_OF_STOCK, or OUTSIDE_TNT (outside the transit-time network -- stocked, but not deliverable to the requested destination in the promised window).
    - `not_found` string[]
    - `source_url` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)