---
title: "Create burst requests for on-demand mapping"
method: POST
path: "/burst/create"
tags: ["bursts"]
---

# Create burst requests for on-demand mapping

`POST /burst/create`

Request fresh imagery at specific locations. Network devices in the area are dispatched to capture it. Pay only on success.

## Request body

- BurstRequest[]
  - `geojson` object, required — GeoJSON Point with radius
    - `type` 'Point'
    - `coordinates` number[]
    - `radius` number — Radius in meters
  - `credits` integer — Credits to allocate

## Response `200`

Created burst locations

- BurstLocation[]
  - `id` string
  - `status` 'active' | 'expired' | 'refunded' | 'completed'
  - `location` object
    - `lat` number
    - `lng` number
  - `geojson` GeoJSONPolygon
    - `type` 'Polygon', required
    - `coordinates` array[], required
      - array[]
        - number[]
  - `validFrom` string, date-time
  - `validUntil` string, date-time
  - `hit` boolean
  - `hitTimestamp` string, date-time, nullable
  - `credits` integer

## Other responses

- `400` — Bad Request — invalid geometry, missing required fields, or malformed JSON
- `402` — Payment Required — insufficient credits
- `403` — Forbidden — missing or invalid API key
- `429` — Too Many Requests — rate limit exceeded (default: 100 req/min)

---

[API](https://skmtc.dev/beemaps/apis/bee-maps-data-api.md) · [All operations](https://skmtc.dev/beemaps/apis/bee-maps-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/beemaps/bee-maps-data-api/revisions/fcbfc9ebaf37/schema)