curl --fail-with-body -X GET "$RAWCHUNKS_API/api/albums/$(jq -nr --arg v "$ID" '$v|@uri')"
{
"id": "<string>",
"title": "<string>",
"creator": "<string>",
"songs": [
{
"id": "<string>",
"title": "<string>",
"creator": "<string>",
"url": "<string>",
"created_at": "<string>",
"family": {},
"basis": {},
"source": {},
"metadata_cid": {},
"image": {},
"album_id": {},
"network": {},
"chain_song_id": {},
"tx_hash": {},
"version": 123,
"licenses": 123,
"stream_price": 123,
"license_price": 123,
"duration": {},
"tags": [
"<string>"
],
"public": true
}
]
}Albums
Read an album
Read an album and its associated songs.
GET
/
api
/
albums
/
{id}
curl --fail-with-body -X GET "$RAWCHUNKS_API/api/albums/$(jq -nr --arg v "$ID" '$v|@uri')"
{
"id": "<string>",
"title": "<string>",
"creator": "<string>",
"songs": [
{
"id": "<string>",
"title": "<string>",
"creator": "<string>",
"url": "<string>",
"created_at": "<string>",
"family": {},
"basis": {},
"source": {},
"metadata_cid": {},
"image": {},
"album_id": {},
"network": {},
"chain_song_id": {},
"tx_hash": {},
"version": 123,
"licenses": 123,
"stream_price": 123,
"license_price": 123,
"duration": {},
"tags": [
"<string>"
],
"public": true
}
]
}The response is an album object with a
songs array. Do not use this route as a private-media access check.
Headers and parameters
string
required
Resource ID.
Response (200)
Success.string
string
string
object[]
Show Properties
Show Properties
string
required
string
required
string
required
string
required
string
string | null
string | null
string | null
string | null
string | null
string | null
string | null
string | null
string | null
integer
integer
number
Listed USDC per minute.
number
Listed USDC per license.
number | null
Seconds.
string[]
boolean
Catalog visibility. Media URLs are not private storage.
Errors
Failed JSON responses contain anerror string. Check the HTTP status before reading a successful result. See job handling for interrupted or uncertain submissions.
| Status | Meaning |
|---|---|
400 | Invalid request. |
500 | Request failed. |
curl --fail-with-body -X GET "$RAWCHUNKS_API/api/albums/$(jq -nr --arg v "$ID" '$v|@uri')"
⌘I