GET
AlbumsGet Album
Fetch a single album by Tune ID.
/v1/albums/:tune_idMethod
GET
Path
/v1/albums/:tune_id
Group
Albums
Overview
How to use this endpoint
Use this endpoint when you need structured API data in a predictable JSON shape. Reference the request example, required parameters, and response fields below to wire it into your product or internal tool.
Response format
JSON response
All successful responses return data in a stable JSON envelope and use Tune UUIDs for resource identifiers.
Code example
Example request
request
Copy-ready
GET /v1/albums/7c9e6679-7425-40de-944b-e07fc1f90ae7Request parameters
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
tune_id | uuid | Yes | Stable Tune identifier for the requested resource. |
Response schema
Response fields
| Field | Type | Description |
|---|---|---|
tune_id | uuid | Unique Tune album identifier. |
name | string | Album title. |
album_type | string | album, single, or compilation. |
release_date | string | Release date string. |
release_date_precision | string | year, month, or day. |
total_tracks | integer | Total tracks on the release. |
label | string | null | Record label. |
popularity | integer | Relative popularity score from 0 to 100. |
genres | string[] | Genres associated with the album. |
available_markets | string[] | Country codes where the album is available. |
images | object[] | Artwork images with url, width, and height. |
Code example
Example response
application/json
Copy-ready
{
"data": {
"tune_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name": "Signal Loss",
"album_type": "album",
"release_date": "2023-06-14",
"release_date_precision": "day",
"total_tracks": 12,
"label": "Future Transmissions",
"popularity": 64,
"genres": ["electronic"],
"available_markets": ["US", "GB", "CA"],
"images": [
{
"url": "https://cdn.tune.dev/images/7c9e6679_640.jpg",
"width": 640,
"height": 640
}
]
}
}Next steps