Get inventory data

Get information for one or many stores and their in-stock data for a given UPC (Universal Product Code).

Query Params
int32

The ID of the company. Required unless company_slug is provided. For style-based queries on products owned by another brand (e.g. a retailer reselling a third-party product), this must be the product owner's company_id, not the requesting partner's.

string

Alternative to company_id. The brand's slug (lowercase, alphanumeric, spaces replaced with hyphens — derived from the brand name). When provided without company_id, the company_id is resolved server-side. Useful for cross-brand style lookups where the storefront doesn't track numeric company_ids.

int32

The ID of the company. Set to include authorized dealers.

int32

The ID of the store.

string

The UPC code to retrieve stores and in-stock data for.

string

The brand's style identifier as stored in Locally (typically the style_number from the brand's product feed — often a model name or SKU root, not a partner's internal model ID). Resolves to a product within the company_id (or company_slug) scope. For cross-brand / reseller scenarios, the company must be the product owner, not the requesting partner — otherwise no product will match and inventory will come back empty. If you don't know the owner, use upc instead.

string
enum
required

The distance unit for the geographical region.

Allowed:
int32
required

The diagonal distance of the geographical region. Specify 1 if only_store_id is specified.

string

Required if only_store_id is not specified. The latitude of the geographical region center.

string

Required if only_store_id is not specified. The longitude of the geographical region center.

string

Results are cached by default for stateful (session) requests. Set to 'true' to invalidate the cache.

string

Comma delimited list of statuses to filter by. Valid statuses are IN_STOCK, PTP_BOPIS, PTP_ROPIS, PTP_SDD and PTP_STS.

Headers
string
required

Locally API token must be passed in the header to authenticate the API consumer

Responses
200

Successful

400

Bad Request

401

Unauthorized

402

Request Failed

403

Forbidden

404

Not Found

429

Too Many Requests

500

Server Error

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here!