Media and utilities

Chip lookups and questions count against a daily quota per key, because each one runs an AI model.

• GET/v1/media/{id}/thumbnailGet a thumbnail
• POST/v1/chip-lookupsRead a microchip number
• POST/v1/insights/queriesAsk a question

Get a thumbnail

GET/v1/media/{id}/thumbnail

Requires the scope conversations:read.

Available from phase 1

A small JPEG of a photo or video. Unlike originals, thumbnails are served by the API and need the key.

Request

curl "https://api.ambula.nl/v1/media/img_1/thumbnail" \
  -H "Authorization: Bearer amb_live_<key>" \
  -o thumbnail.jpg

Read a microchip number

POST/v1/chip-lookups

Requires the scope chips:read.

Available from phase 4

Read a microchip number from a photo of a chip reader, and look it up in the Dutch registries. Counts against a daily quota.

Request

curl -X POST "https://api.ambula.nl/v1/chip-lookups" \
  -H "Authorization: Bearer amb_live_<key>" \
  -F "image=@reader.jpg"

Response · 200

{
  "number": "528140000123456",
  "registration_found": true,
  "links": [
    "https://www.chipnummer.nl/…"
  ]
}

Ask a question

POST/v1/insights/queries

Requires the scope insights:read.

Available from phase 4

Ask a question about the company's conversations and rides, as in Inzichten. The answer streams as server-sent events. Requires the insights module; counts against a daily quota.

Body

questionstringrequired

The question.

Request

curl -X POST "https://api.ambula.nl/v1/insights/queries" \
  -H "Authorization: Bearer amb_live_<key>" \
  -H "Idempotency-Key: 4f1c9a2e-…" \
  -H "Content-Type: application/json" \
  -d '{"question":"Hoeveel zwanen deze maand?"}'

Response · 200 · text/event-stream

event: answer
data: {"text":"Deze maand 14 meldingen over zwanen…"}

event: done
data: {}