---
title: "Index Product Locations"
method: GET
path: "/products/{product_id}/locations"
tags: ["Products"]
---

# Index Product Locations

`GET /products/{product_id}/locations`

## Request

- Base URL: `https://api.liftforward.com`
- URL: `https://api.liftforward.com/products/{product_id}/locations`
- Auth: API key in header `Api-Key`

Returns the per-location availability and inventory messaging configured for the Product.

Supply a `location_id` (LiftForward id) or `merchant_location_id` (your own id) to fetch a single Location. Use the `page` and `per_page` parameters to paginate the results.

## Path parameters

- `product_id` string, required

## Query parameters

- `page` integer
- `per_page` integer
- `location_id` string
- `merchant_location_id` string

## Response `200`

Index Product Locations

- MerchantApiEntitiesProductLocationsResponse: MerchantApi_Entities_ProductLocationsResponse model
  - `product_locations` MerchantApiEntitiesProductLocationEntity[]
    - `location_id` string, required: LiftForward identifier for the Location.
    - `merchant_location_id` string, required: The Location's identifier in the merchant's own system.
    - `available` boolean, required: Whether the product is available at this Location.
    - `inventory_message` string, required: Inventory message shown for this product at this location. Overrides the product-level message.
    - `inventory_help_message` string, required: Help message shown when hovering the availability help icon for this product at this location.
  - `meta` MetaEntity
    - `page` integer: Current page of results.
    - `per_page` integer: Results per page.
    - `total_pages` integer: Total number of pages in complete result set.
    - `total_records` integer: Total number of records in the complete result set.

## Other responses

- `401`: Unauthorized
- `405`: Not Allowed
- `408`: Request Time Out
- `500`: Internal Service Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/liftforward/apis/device-as-a-service-merchant-apis-lift-daas-service-producti.md) - [All operations](https://skmtc.dev/liftforward/apis/device-as-a-service-merchant-apis-lift-daas-service-producti/llms.txt) - [OpenAPI document](https://skmtc.dev/liftforward/apis/device-as-a-service-merchant-apis-lift-daas-service-producti/revisions/5a1383ffd271?raw)