# Get album
URL: https://musicapi.com/docs/reference/get-album.md

`GET https://api.musicapi.com/api/{integrationUserUUID}/albums/{albumId}`

Section: Read and write a user's library.
Product: MusicAPI Core.
Auth: Basic, DevToken, DocsSession (any one of them). Use Basic with your Client ID and Client Secret from your server only.

This endpoint fetches specified album and returns information about it.

## Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `integrationUserUUID` | uuid | yes | The connected user: the `integrationUserUUID` from the sign-in callback. |
| `albumId` | string | yes | ID of the album |

## Response 200

ok

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | yes |  |
| `name` | string | yes |  |
| `totalItems` | number \| null | yes |  |
| `imageUrl` | string \| null | yes |  |
| `artists` | ArtistSimplified[] \| null | yes |  |
| `artists.id` | string \| null | yes |  |
| `artists.entryId` | string \| null | yes | Identifier associated with an artist within a user's library. Artist entry id can be obtained during fetching artists from user's library. |
| `artists.name` | string | yes |  |
| `artists.imageUrl` | string \| null | yes |  |
| `artists.followers` | number \| null | yes |  |

```json
{
  "id": "4Gfnly5CzMJQqkUFfoHaP3",
  "name": "Meteora",
  "totalItems": 13,
  "imageUrl": "https://www.example-image.com/978263478234",
  "artists": [
    {
      "id": "53XhwfbYqKCa1cC15pYq2q",
      "entryId": "53XhwfbYqKCa1cC15pYq2q",
      "name": "Imagine Dragons",
      "imageUrl": "https://i.scdn.co/image/ab6761610000e5ebab47d8dae2b24f5afe7f9d38",
      "followers": 53107521
    }
  ]
}
```

## Errors

- 404: Your account has no connected user with this uuid, or the item does not exist.
- 412: The user must sign in again (`IntegrationUserNotAuthenticated`).
- 429: Too many requests. Wait for the seconds in `Retry-After`.

## Example

```bash
curl https://api.musicapi.com/api/{integrationUserUUID}/albums/{albumId} \
  -u "$MUSICAPI_CLIENT_ID:$MUSICAPI_CLIENT_SECRET"
```