Tracks

Bulk resolve

Resolve up to 100 inputs (track names, ISRCs, or platform IDs) in a single request to canonical Sonovault tracks plus their cross-platform links. One credit is charged per input line. If your monthly quota runs out mid-batch the response is partial: unresolved lines come back with status skipped_no_credits instead of an error.

Response

  • results - one entry per input line, in input order: { input, status, track, links }, where status is matched, not_found, or skipped_no_credits.

  • partial, processed, credits_used, credits_remaining, message - the batch billing summary.

post/v1/tracks/resolve

Request

  • Base URL: https://api.sonovault.now
  • URL: https://api.sonovault.now/v1/tracks/resolve
  • Auth: API key in header x-api-key

Request body

input_typestring required

one of track_name, isrc, sonovault_id, spotify_id, applemusic_id, tidal_id, beatport_id, discogs_id, musicbrainz_id.

itemsstring required

1 to 100 entries. For track_name, each entry is an object { artist, title }; for every other input type, each entry is a string.

Response

Successful response

partialboolean required

true when your quota ran out mid-batch and some rows came back skipped_no_credits.

processedinteger required

How many input lines were actually resolved.

credits_usedinteger required

Credits charged for this call, one per resolved line.

credits_remaininginteger required

Credits left in your monthly quota after this call.

messagestring nullable required

Explanation when the batch was cut short. null on a complete batch.

Changes

No recorded changes to this operation across all 1 revision of this API.