Skip to main content
GET
Poll a beat-mapping job

Authorizations

Authorization
string
header
required

Your API key as a Bearer token, e.g. Authorization: Bearer vbsk_live_...

Path Parameters

job_id
string
required

Response

The finished beat grid.

A track's beat grid. Times are seconds from the start of the audio.

job_id
string
track_id
string | null

Whatever you sent on submit.

status
enum<string>
Available options:
complete
duration_seconds
number
Example:

184.2

tempo_bpm
number
Example:

128.02

beats
number[]

Every beat, in seconds.

Example:
downbeats
number[]

The subset of beats that opens a bar, so one response drives both a beat grid and a bar grid.

Example:
billed_minutes
integer

Minutes of audio billed, rounded up with a one-minute minimum.

Example:

4

cached
boolean

True when this account had already mapped these exact bytes, so the grid came from cache and the analysis did not re-run. Does not change what the call costs.