---
title: "Magic Job delivered a batch of images"
method: POST
path: "magicJobImagesDelivered"
---

# Magic Job delivered a batch of images

`POST magicJobImagesDelivered` (webhook)

Sent every time a Magic Job delivers a batch of images. A job can deliver several batches, so
several events may arrive for the same `magic_job.uid`, each with a different `delivery_uid`.
Treat every delivery the same way: call `listMagicJobImages` and replace what you stored for that job.

## Payload

- MagicJobImagesDeliveredEvent
  - `type` 'images_delivered', required
  - `magic_job` object, 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
    - `delivery_uid` string, uuid, required: Identifies this delivery batch.

## Acknowledgement `200`

Return any 2xx status to acknowledge the event.

---

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