---
title: "List a Magic Job's images"
method: GET
path: "/magic-jobs/{magic_job_uid}/images"
tags: ["Images"]
---

# List a Magic Job's images

`GET /magic-jobs/{magic_job_uid}/images`

## Request

- Base URL: `https://api.snappr.com`
- URL: `https://api.snappr.com/magic-jobs/{magic_job_uid}/images`
- Auth: HTTP bearer

Lists the current complete set of delivered images for a Magic Job, across all delivery batches.
Each result is one image for one menu item. If Snappr replaces an image after delivery it keeps
its `uid` (the stable handle for diffing) while `internal_ids` and URLs may change. URLs are
signed and expire at `url_expires_at`; call again for freshly signed URLs.

## Path parameters

- `magic_job_uid` string, uuid, required

## Query parameters

- `limit` integer
- `offset` integer

## Headers

- `accept-version` string

## Response `200`

A page of images.

- object
  - `count` integer, required: Number of items in this page.
  - `limit` integer, required
  - `offset` integer, required
  - `total` integer, required: Number of items across all pages.
  - `results` MagicJobImage[], required
    - `uid` string, uuid, required: Stable identifier; kept if the image is replaced.
    - `file_name` string
    - `menu_item_name` string
    - `internal_ids` string[], required: The menu item's identifier(s) in your catalog, as found on the source platform. Treat as opaque strings.
    - `width` integer
    - `height` integer
    - `content_type` string
    - `url_original` string, uri, required: Signed full-quality URL; expires at `url_expires_at`.
    - `url_thumb` string, uri, required: Signed thumbnail URL; expires at `url_expires_at`.
    - `url_expires_at` string, date-time, required

## Other responses

- `400`: The request was invalid, or could not be fulfilled (validation failure, no coverage, no availability, location outside your region).
- `401`: The API key is missing or invalid, or its user is not an admin of the account.
- `404`: The resource does not exist or does not belong to your account.
- `429`: Rate limit exceeded (1,000 requests per minute per API key).
- `500`: Unexpected server error. Try again later.

---

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