Access: organization users with release permissions; X-User-Id may target a same-organization user where allowed.
GET
https://enterprise.spacemedia.uk
/
api
/
v1
/
releases
/
{id}
View Release
curl --request GET \
--url https://enterprise.spacemedia.uk/api/v1/releases/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://enterprise.spacemedia.uk/api/v1/releases/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://enterprise.spacemedia.uk/api/v1/releases/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}import requests
url = "https://enterprise.spacemedia.uk/api/v1/releases/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "f78c0f2e-4b30-4b33-87c5-e0bbd17b2b85",
"uuid": "f78c0f2e-4b30-4b33-87c5-e0bbd17b2b85",
"title": "Midnight Signals",
"status": "draft",
"created_at": "2026-04-15T10:20:00+00:00",
"viewUrl": "/releases/f78c0f2e-4b30-4b33-87c5-e0bbd17b2b85/edit",
"created_by": {
"id": "9d7046b2-3ab1-4c9d-9bd8-90bbd22b7df2",
"uuid": "9d7046b2-3ab1-4c9d-9bd8-90bbd22b7df2",
"organization_id": "2a8d3e82-4a9d-4e33-9d3b-85bb1a93e8d4",
"organization_uuid": "2a8d3e82-4a9d-4e33-9d3b-85bb1a93e8d4",
"name": "Maya Chen",
"full_name": "Maya Chen",
"first_name": "Maya",
"last_name": "Chen",
"email": "maya.chen@example.test",
"phone": "+442071838750",
"language": "en",
"country": "United Kingdom",
"address": "22 Demo Lane, London",
"photo": null,
"profile_photo": null,
"verified": true,
"email_verified_at": "2026-04-10T08:15:00+00:00",
"last_login_at": "2026-04-18T08:45:00+00:00",
"created_at": "2026-03-20T09:00:00+00:00",
"updated_at": "2026-04-18T08:45:00+00:00",
"is_suspended": false,
"suspended_at": null,
"invitation_status": "accepted",
"is_invited": false,
"roles": [
{
"id": "role-admin-demo",
"uuid": "role-admin-demo",
"name": "Admin"
}
]
},
"cover_art": "https://cdn.spacemedia.uk/demo/releases/midnight-signals-cover.jpg",
"image": "https://cdn.spacemedia.uk/demo/releases/midnight-signals-cover.jpg",
"resizedImage": "https://cdn.spacemedia.uk/demo/releases/midnight-signals-cover-512.jpg",
"numberOfTracks": 2,
"scheduled_date": "2026-06-19",
"version": null,
"label": "Demo Label",
"genre": "Electronic",
"secondary_genre": "Ambient",
"language": "English",
"is_copyrighted": false,
"copyright_links": [],
"is_parental_advisory": false,
"format": "single",
"upc_code": "5051234567890",
"reference_number": "DLG-2026-001",
"gidr": null,
"description": "A production-safe demo release used in API examples.",
"price_category": "mid",
"digital_release_date": "2026-06-19",
"original_release_date": "2026-04-01",
"license_type": "copyright",
"creative_commons_license": null,
"license_holder_year": 2026,
"license_holder_name": "Demo Label Group Ltd",
"sound_recordings_copyright_year": 2026,
"sound_recordings_copyright_name": "Demo Label Group Ltd",
"distribution": {
"channels": [
"spotify",
"apple_music",
"youtube_music"
]
},
"territories": [
"GB",
"US",
"DE"
],
"submitted_at": null,
"artists": [
{
"id": "4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b",
"uuid": "4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b",
"name": "Nova Vale",
"url": "/artists/4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b",
"viewUrl": "/artists/4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b",
"editRoute": "/artists/4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b/edit",
"artist_type": "Primary Artist",
"spotify_id": "6dDemoNovaVale",
"releases_count": 1,
"tracks_count": 2,
"total_releases": 1,
"total_tracks": 2,
"total_streams": 125000,
"metadata": {
"country": "GB"
},
"created_at": "2026-03-22T11:00:00+00:00",
"updated_at": "2026-04-15T10:20:00+00:00"
}
]
}
]
}{
"success": false,
"message": "Missing bearer token"
}{
"success": false,
"message": "This action is unauthorized."
}{
"success": false,
"message": "Resource not found"
}{
"success": false,
"message": "Validation failed.",
"errors": {
"title": [
"The title field is required."
]
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Use application/json for API responses.
Bearer access token. Use Bearer <YOUR_ACCESS_TOKEN>.
Optional same-organization user UUID. Policies still apply.
Path Parameters
The ID of the release.
Query Parameters
Search term scoped to the authenticated organization.
Response
Success
The response is of type object.
Previous
Update ReleaseAccess: organization users with release permissions; `X-User-Id` may target a same-organization user where allowed.
Next
⌘I
View Release
curl --request GET \
--url https://enterprise.spacemedia.uk/api/v1/releases/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://enterprise.spacemedia.uk/api/v1/releases/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://enterprise.spacemedia.uk/api/v1/releases/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}import requests
url = "https://enterprise.spacemedia.uk/api/v1/releases/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "f78c0f2e-4b30-4b33-87c5-e0bbd17b2b85",
"uuid": "f78c0f2e-4b30-4b33-87c5-e0bbd17b2b85",
"title": "Midnight Signals",
"status": "draft",
"created_at": "2026-04-15T10:20:00+00:00",
"viewUrl": "/releases/f78c0f2e-4b30-4b33-87c5-e0bbd17b2b85/edit",
"created_by": {
"id": "9d7046b2-3ab1-4c9d-9bd8-90bbd22b7df2",
"uuid": "9d7046b2-3ab1-4c9d-9bd8-90bbd22b7df2",
"organization_id": "2a8d3e82-4a9d-4e33-9d3b-85bb1a93e8d4",
"organization_uuid": "2a8d3e82-4a9d-4e33-9d3b-85bb1a93e8d4",
"name": "Maya Chen",
"full_name": "Maya Chen",
"first_name": "Maya",
"last_name": "Chen",
"email": "maya.chen@example.test",
"phone": "+442071838750",
"language": "en",
"country": "United Kingdom",
"address": "22 Demo Lane, London",
"photo": null,
"profile_photo": null,
"verified": true,
"email_verified_at": "2026-04-10T08:15:00+00:00",
"last_login_at": "2026-04-18T08:45:00+00:00",
"created_at": "2026-03-20T09:00:00+00:00",
"updated_at": "2026-04-18T08:45:00+00:00",
"is_suspended": false,
"suspended_at": null,
"invitation_status": "accepted",
"is_invited": false,
"roles": [
{
"id": "role-admin-demo",
"uuid": "role-admin-demo",
"name": "Admin"
}
]
},
"cover_art": "https://cdn.spacemedia.uk/demo/releases/midnight-signals-cover.jpg",
"image": "https://cdn.spacemedia.uk/demo/releases/midnight-signals-cover.jpg",
"resizedImage": "https://cdn.spacemedia.uk/demo/releases/midnight-signals-cover-512.jpg",
"numberOfTracks": 2,
"scheduled_date": "2026-06-19",
"version": null,
"label": "Demo Label",
"genre": "Electronic",
"secondary_genre": "Ambient",
"language": "English",
"is_copyrighted": false,
"copyright_links": [],
"is_parental_advisory": false,
"format": "single",
"upc_code": "5051234567890",
"reference_number": "DLG-2026-001",
"gidr": null,
"description": "A production-safe demo release used in API examples.",
"price_category": "mid",
"digital_release_date": "2026-06-19",
"original_release_date": "2026-04-01",
"license_type": "copyright",
"creative_commons_license": null,
"license_holder_year": 2026,
"license_holder_name": "Demo Label Group Ltd",
"sound_recordings_copyright_year": 2026,
"sound_recordings_copyright_name": "Demo Label Group Ltd",
"distribution": {
"channels": [
"spotify",
"apple_music",
"youtube_music"
]
},
"territories": [
"GB",
"US",
"DE"
],
"submitted_at": null,
"artists": [
{
"id": "4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b",
"uuid": "4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b",
"name": "Nova Vale",
"url": "/artists/4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b",
"viewUrl": "/artists/4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b",
"editRoute": "/artists/4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b/edit",
"artist_type": "Primary Artist",
"spotify_id": "6dDemoNovaVale",
"releases_count": 1,
"tracks_count": 2,
"total_releases": 1,
"total_tracks": 2,
"total_streams": 125000,
"metadata": {
"country": "GB"
},
"created_at": "2026-03-22T11:00:00+00:00",
"updated_at": "2026-04-15T10:20:00+00:00"
}
]
}
]
}{
"success": false,
"message": "Missing bearer token"
}{
"success": false,
"message": "This action is unauthorized."
}{
"success": false,
"message": "Resource not found"
}{
"success": false,
"message": "Validation failed.",
"errors": {
"title": [
"The title field is required."
]
}
}