# Get a catalogue
URL: https://musicapi.com/docs/reference/recommendations-get-catalogue.md

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

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.

The status and the coverage report of one catalogue. `isrcs`: the unique valid ISRCs. `invalid`: the lines that are not an ISRC. `matched`: the ISRCs we know. `withVector`: the matched ISRCs that can appear in results. `coverage` = `withVector / isrcs`. A matched track without a vector is still a valid seed.

## Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `catalogueId` | string | yes | The catalogue id from `POST /public/recommendations/catalogues`. |

## Response 200

ok

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

```json
{
  "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.
- 404: `catalogue_not_found`: the catalogue does not exist or is not yours.
- 429: Your account sent more calls this minute than its rate limit allows.

## Example

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