GET /v1/jobs/{job_id}

Poll an async job

Returns the current state of an async job dispatched by `POST /v1/audio-features/{upload,url}`. Polling is free and rate-limited separately from feature credits. When `?format=spotify` is set, the `result` field (on complete) carries the Spotify-compatible shape instead of the canonical one.

Parameters

NameInTypeRequiredDescription
job_id path string yes
format query string no

Example request

cURL
curl https://api.brizm.dev/v1/jobs/{job_id} \
  -G \
  --data-urlencode "format=<value>" \
  -H "Authorization: Bearer tl_live_xxx"

Responses

200 — Job state

404 — Unknown job_id