---
title: "List a product's references, with positions"
method: GET
path: "/products/{id}/references"
---

# List a product's references, with positions

`GET /products/{id}/references`

## Request

- Base URL: `https://www.merchkit.com/api/v1`
- URL: `https://www.merchkit.com/api/v1/products/{id}/references`
- Auth: HTTP bearer

The key-scoped reference view: `{ <attribute-key>: { total, has_more, items: [{id, type, label, position}] } }`. Forward list references return the same complete membership that embeds in `attributes`, plus explicit `position`. INVERSE references — which never embed in `attributes` because they are unbounded — are readable ONLY here: pass `?attribute=<key>` and page with `limit`/`offset` (or traverse from the other side with `filter[<forward-key>]=<id>`).

Scope: `read:products`.

## Query parameters

- `attribute` string
- `limit` integer
- `offset` integer

## Response `200`

References grouped by attribute key.

- object
  - `data` object

## Other responses

- `404`: Product or reference attribute not found.

---

[API](https://skmtc.dev/merchkit/apis/merchkit-api.md) - [All operations](https://skmtc.dev/merchkit/apis/merchkit-api/llms.txt) - [OpenAPI document](https://skmtc.dev/merchkit/apis/merchkit-api/revisions/3062ca814757?raw)