---
title: "GET /product-inventory/by-product-variant-ids"
method: GET
path: "/product-inventory/by-product-variant-ids"
tags: ["Inventory"]
---

# GET /product-inventory/by-product-variant-ids

`GET /product-inventory/by-product-variant-ids`

## Request

- Base URL: `https://www.faire.com/external-api/v2`
- URL: `https://www.faire.com/external-api/v2/product-inventory/by-product-variant-ids`
- Auth: API key in header `X-FAIRE-OAUTH-ACCESS-TOKEN` and API key in header `X-FAIRE-APP-CREDENTIALS`
- TypeScript: <https://skmtc.dev/faire/apis/faire-external-api/docs/product-inventory/by-product-variant-ids/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint fetches inventory levels by given product variant IDs.

## Query parameters

- `ids` string

## Response `200`

Successful response

- GetInventoryResponseV2: Response containing inventory levels for product variants, mapped by SKU or variant ID.
  - `inventories` object

## Other responses

- `400`: Bad Request -- Your request is invalid.
- `401`: Unauthorized -- Your API key is wrong.
- `404`: Not found -- The requested resource could not be found.
- `405`: Method Not Allowed -- You tried to access an entity with an invalid method.
- `429`: Too Many Requests.
- `500`: Internal Server Error -- We had a problem with our server. Try again later.
- `503`: Service Unavailable -- We're temporarily offline for maintenance. Please try again later.

---

[API](https://skmtc.dev/faire/apis/faire-external-api.md) - [All operations](https://skmtc.dev/faire/apis/faire-external-api/llms.txt) - [OpenAPI document](https://skmtc.dev/faire/apis/faire-external-api/revisions/19558399745c?raw)