---
title: "Get a Magic Job"
method: GET
path: "/magic-jobs/{magic_job_uid}"
tags: ["Magic Jobs"]
---

# Get a Magic Job

`GET /magic-jobs/{magic_job_uid}`

## Request

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

Retrieves one Magic Job. A job moves through `created`, `in_progress`, `completed` and `failed`.
It stays `in_progress` while further deliveries are expected and becomes `completed` once all
images are delivered, at which point `completed_at` and `images_count` are populated. Failed
jobs are followed up by your account manager.

## Path parameters

- `magic_job_uid` string, uuid, required

## Headers

- `accept-version` string

## Response `200`

The Magic Job.

- MagicJob
  - `uid` string, uuid, required
  - `type` 'menu', required
  - `status` 'created' | 'in_progress' | 'completed' | 'failed', required
  - `completed_at` string, date-time, nullable
  - `restaurant_name` string, nullable
  - `restaurant_address` string, nullable
  - `source_platform` string, nullable: Platform Snappr found the listing on.
  - `source_url` string, uri, nullable
  - `internal_id` string, nullable
  - `images_count` integer: Number of delivered images. Present only when `status` is `completed`.
  - `created_at` string, date-time
  - `updated_at` string, date-time

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