---
title: "List Magic Jobs"
method: GET
path: "/magic-jobs"
tags: ["Magic Jobs"]
---

# List Magic Jobs

`GET /magic-jobs`

## Request

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

Lists the Magic Jobs created under your account.

## Query parameters

- `limit` integer
- `offset` integer

## Headers

- `accept-version` string

## Response `200`

A page of Magic Jobs.

- 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` MagicJob[], required
    - `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.
- `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)