---
title: "Get an image"
method: GET
path: "/images/{id}"
---

# Get an image

`GET /images/{id}`

## Request

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

Full detail, same shape as the list rows. `label` is the workspace's primary-attribute value (render `label ?? id`); `attributes` is sparse — a missing key means unset or not-applicable (read `attributes[key] ?? null`). Narrow the returned keys with `fields=<key>,<key>`.

Scope: `read:images`.

## Query parameters

- `fields` string

## Response `200`

The image.

- object
  - `data` EntityResource: The one shape for every entity read and mutation response. System fields live at the top level; every customer-defined key lives in `attributes`, so customer keys can never collide with system ones.
    - `id` string, uuid, required
    - `type` 'product' | 'image' | 'vendor' | 'category' | 'source', required: The entity type discriminator.
    - `label` string, nullable, required: The workspace's primary-attribute value for this entity; null when no primary attribute is configured or it is unset (never a UUID posing as a name). Render `label ?? id`.
    - `parent_id` string, uuid, nullable, required: Parent entity id (products: the variant parent).
    - `created_at` string, date-time, nullable, required
    - `updated_at` string, date-time, nullable, required
    - `attributes` object, required: SPARSE map of customer-defined keys — only keys with values appear; a missing key means unset or not-applicable (read `attributes[key] ?? null`; never contains null or ""). Scalars are bare values; a single reference is a labeled stub; a list reference is a COMPLETE ordered stub array (no cap, array order = position order). Inverse-reference keys never appear — traverse them via filters or `/products/{id}/references`. The full key list comes from `GET /attributes`.

## Other responses

- `404`: Not found — ids outside your workspace are indistinguishable from missing.

---

[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)