> ## Documentation index
> Fetch the complete documentation index at: https://dronebundle.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# scan.ready

> Received when a drone map has finished processing.

Event triggered when a drone map finishes processing and is ready to view in the dashboard. Fields that do not apply to the map, such as `model` on a 2D map, are left out of `data`.

## Response Body Parameters

All webhook payloads follow a consistent top-level structure with event-specific data nested within the `data` object.

**delivery_id** `string`

Unique identifier for this delivery. Use this to deduplicate events.

**event** `string`

The event type that triggered the webhook (e.g., `scan.ready`).

**timestamp** `number`

Unix timestamp (milliseconds) when the event was delivered.

**workspace_id** `string`

The workspace where the event occurred.

**data** `object`

The finished map.

**id** `string`

Unique identifier for the map.

**name** `string`

Map name.

**profile** `string`

What the map produces. One of: `map` (measurable 2D map), `map3d` (2D map plus a textured 3D model), `thermal` (thermal map).

**status** `string`

Map status. Always `ready` for this event.

**project_id** `string`

The project the map belongs to.

**job_id** `string`

The job whose photos the map is made from.

**project_name** `string`

Project name when the map was started.

**job_name** `string`

Job name when the map was started.

**photo_count** `number`

Number of photos sent for processing.

**created** `number`

Unix timestamp (milliseconds) when the map was started.

**updated** `number`

Unix timestamp (milliseconds) when the map was last updated.

**created_by** `object`

The user who started the map.

**type** `string`

Either `user` or `api_key`.

**id** `string`

User ID or API key ID.

**started_at** `number`

Unix timestamp (milliseconds) when processing started.

**finished_at** `number`

Unix timestamp (milliseconds) when processing ended.

**total_seconds** `number`

How long processing took, in seconds.

**photos_skipped_count** `number`

Photos that could not be used in the map.

**orthophoto** `object`

The 2D map.

**width** `number`

Width in pixels.

**height** `number`

Height in pixels.

**crs** `string | null`

Coordinate reference system of the map file (e.g., `EPSG:32633`).

**bounds** `number[]`

Area the map covers as `[west, south, east, north]` in longitude and latitude.

**center** `number[]`

Center of the map as `[longitude, latitude]`.

**gsd_cm** `number | null`

Ground sample distance: how many centimeters one pixel covers.

**reconstruction** `object`

How much of the photo set went into the result.

**images_total** `number | null`

Photos processed.

**images_reconstructed** `number | null`

Photos placed in the result.

**points** `number | null`

Number of 3D points.

**camera_gsd_cm** `number | null`

Average ground sample distance of the photos, in centimeters.

**area_square_meters** `number | null`

Area covered, in square meters.

**point_cloud** `object`

The point cloud, when one was made.

**format** `string`

File format. One of: `copc`, `laz`.

**model** `object`

The 3D model, on `map3d` maps.

**kind** `string`

One of: `full` (textured model of the whole area), `surface` (surface model).

**bytes** `number`

File size in bytes.

### Example response

```json Example Payload
{
  "delivery_id": "019d5a10-3c42-7d81-9b6e-2f4c8a1e7d90",
  "event": "scan.ready",
  "timestamp": 1775201234567,
  "workspace_id": "01986573-8d04-72fc-85b3-573c77a18511",
  "data": {
    "id": "019d5a0e-77a1-7c2b-8f30-6d2e9b4c1a55",
    "name": "Building A roof",
    "profile": "map3d",
    "status": "ready",
    "project_id": "01964c6b-7a3e-7f00-8000-abc123def456",
    "job_id": "019d4350-a1b2-7c3d-8e4f-567890abcdef",
    "project_name": "Westfield Bridge Inspection",
    "job_name": "Roof Inspection - Building A",
    "photo_count": 412,
    "created": 1775198400000,
    "updated": 1775201230000,
    "created_by": {
      "type": "user",
      "id": "03144892-6021-705a-08f2-8e147cff3f28"
    },
    "started_at": 1775198460000,
    "finished_at": 1775201230000,
    "total_seconds": 2770,
    "photos_skipped_count": 3,
    "orthophoto": {
      "width": 18432,
      "height": 15360,
      "crs": "EPSG:32633",
      "bounds": [12.5641, 55.6742, 12.5712, 55.6786],
      "center": [12.5676, 55.6764],
      "gsd_cm": 1.8
    },
    "reconstruction": {
      "images_total": 412,
      "images_reconstructed": 409,
      "points": 18734211,
      "camera_gsd_cm": 1.7,
      "area_square_meters": 41250
    },
    "point_cloud": {
      "format": "copc"
    },
    "model": {
      "kind": "full",
      "bytes": 734003200
    }
  }
}
```

Web version: https://dronebundle.com/docs/webhooks/scan-ready
