- API reference
- 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
required
withVector / 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
{
"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.