# List catalogues
URL: https://musicapi.com/docs/reference/recommendations-list-catalogues.md

`GET https://api.musicapi.com/public/recommendations/catalogues`

Section: Recommendations.
Product: MusicAPI Core.
Auth: Basic, Token, DevToken, DocsSession (any one of them). Use Basic with your Client ID and Client Secret from your server only.

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

## Response 200

ok

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `catalogues` | RecommendationCatalogue[] | yes |  |
| `catalogues[].id` | string | yes |  |
| `catalogues[].name` | string | yes |  |
| `catalogues[].status` | string | yes | One of: awaitingUpload, processing, ready, failed. |
| `catalogues[].importing` | boolean | yes | True while an import runs. A `ready` catalogue stays `ready` while a new file imports. |
| `catalogues[].isrcs` | number | yes | Unique valid ISRCs. |
| `catalogues[].invalid` | number | yes | Lines of the last file that are not an ISRC. |
| `catalogues[].matched` | number | yes | ISRCs we know. |
| `catalogues[].withVector` | number | yes | Matched ISRCs that can appear in results. |
| `catalogues[].coverage` | number | yes | `withVector / isrcs`. |
| `catalogues[].error` | string \| null | yes | Why 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 | yes |  |
| `catalogues[].updatedAt` | date-time | yes |  |

```json
{
  "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.

## Example

```bash
curl https://api.musicapi.com/public/recommendations/catalogues \
  -u "$MUSICAPI_CLIENT_ID:$MUSICAPI_CLIENT_SECRET"
```
