Skip to the content
  1. API reference
  2. Recommendations

List catalogues

GET/public/recommendations/catalogues
CoreAuthBasicTokenDevTokenDocsSession

Lists your catalogues, the newest first, with their status and coverage.

Response

200application/json · RecommendationCatalogueListok
catalogues
RecommendationCatalogue[]
required
catalogues[].id
string
required
catalogues[].name
string
required
catalogues[].status
string
requiredOne of: awaitingUpload, processing, ready, failed
catalogues[].importing
boolean
requiredTrue while an import runs. A ready catalogue stays ready while a new file imports.
catalogues[].isrcs
number
requiredUnique valid ISRCs.
catalogues[].invalid
number
requiredLines of the last file that are not an ISRC.
catalogues[].matched
number
requiredISRCs we know.
catalogues[].withVector
number
requiredMatched ISRCs that can appear in results.
catalogues[].coverage
number
requiredwithVector / isrcs.
catalogues[].error
string | null
requiredWhy the last import failed: catalogue_limit, upload_missing, file_too_large or import_failed. After a failed new file of a ready catalogue, the status stays ready with the old data.
catalogues[].createdAt
date-time
required
catalogues[].updatedAt
date-time
required
Example answer
{
  "catalogues": [
    {
      "id": "42",
      "name": "Main catalogue",
      "status": "awaitingUpload",
      "importing": true,
      "isrcs": 120000,
      "invalid": 12,
      "matched": 101000,
      "withVector": 88000,
      "coverage": 0.7333,
      "error": "string",
      "createdAt": "2026-10-16T09:41:07.000Z",
      "updatedAt": "2026-10-16T09:41:07.000Z"
    }
  ]
}

Errors

401

No valid credential.

429

Your account sent more calls this minute than its rate limit allows.