API ReferenceAudioVerify™Poll for the result

Poll for the result

Fetch the status of a recognition job. Poll this endpoint after submitting a video until status is completed, then read the track.

GET/api/v4/video-recognition/{job_id}/

Path parameters

ParameterDescription
job_idThe job UUID returned by Submit a video.

Example request

curl https://api.slipstreammusic.com/api/v4/video-recognition/7b2c1e8a-0f4d-4a2b-9c11-7f5a2d9e3c10/ \
  -H "Authorization: Bearer $PARTNER_API_KEY"

Responses (200 OK)

While the job is still running:

{
  "job_id": "7b2c1e8a-0f4d-4a2b-9c11-7f5a2d9e3c10",
  "status": "processing",
  "track": null
}

Completed with a Slipstream catalog match (internal: true, includes the track id):

{
  "job_id": "7b2c1e8a-0f4d-4a2b-9c11-7f5a2d9e3c10",
  "status": "completed",
  "track": {
    "id": "11111111-1111-1111-1111-111111111111",
    "title": "Golden Hour",
    "artist": "The Coast",
    "internal": true,
    "isrc": "USRC12345678",
    "score": 96.5,
    "external_label": null
  }
}

Completed with an outside match carrying a label (here, Epidemic Sound):

{
  "job_id": "7b2c1e8a-0f4d-4a2b-9c11-7f5a2d9e3c10",
  "status": "completed",
  "track": {
    "id": null,
    "title": "Some Stock Track",
    "artist": "A Stock Artist",
    "internal": false,
    "isrc": "SE5Q52400123",
    "score": 100.0,
    "external_label": "Epidemic Sound"
  }
}

Completed with no music recognized:

{
  "job_id": "7b2c1e8a-0f4d-4a2b-9c11-7f5a2d9e3c10",
  "status": "completed",
  "track": null
}

See The RecognitionTrack object for field descriptions.

Polling guidance

  • Poll every 2 to 5 seconds. Most jobs finish within a few seconds to about a minute.
  • Stop polling once status is completed.
  • Results stay available for about a day after completion, then the job_id expires.

Branch on internal: true means the track is in the Slipstream catalog and id links to it. false means it was identified by an outside service; check external_label to flag competitor libraries such as Epidemic Sound.

Errors

HTTPWhen
401 / 403Missing or invalid partner key.
404The job_id does not exist, or it has expired from the cache. Submit the video again.
Get an upload URLGenerate a license