Skip to main content
GET
/
releases
/
{id}
Get Release by ID
curl --request GET \
  --url https://server26-dot-royalti-project.uc.r.appspot.com/releases/{id} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "id": "<string>",
    "TenantId": "<string>",
    "TenantUserId": "<string>",
    "title": "<string>",
    "format": "Single",
    "type": "Audio",
    "version": "<string>",
    "label": "<string>",
    "copyright": "<string>",
    "displayArtist": "<string>",
    "artists": [
      {
        "id": "3816be64-720c-4105-990f-a6b99b0f928b",
        "artistName": "Bally Jhay",
        "type": "primary"
      }
    ],
    "mainGenre": [
      "<string>"
    ],
    "subGenre": [
      "<string>"
    ],
    "contributors": [
      "<string>"
    ],
    "description": "<string>",
    "metadata": {},
    "media": [
      {}
    ],
    "explicit": "explicit",
    "releaseDate": "2023-11-07T05:31:56Z",
    "preReleaseDate": "2023-11-07T05:31:56Z",
    "status": "<string>",
    "tracks": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "TenantId": 123,
        "ReleaseId": "660e8400-e29b-41d4-a716-446655441111",
        "assetId": "770e8400-e29b-41d4-a716-446655442222",
        "trackNumber": 1,
        "title": "My Track Title",
        "version": "Radio Edit",
        "isrc": "USABC1234567",
        "iswc": "T-123456789-0",
        "duration": 213.5,
        "lyrics": "Verse 1\nChorus\nVerse 2",
        "language": "en",
        "displayArtist": "Artist Name",
        "artists": [
          {
            "id": "550e8400-e29b-41d4-a716-446655440000",
            "artistName": "John Doe",
            "type": "primary"
          },
          {
            "id": "660e8400-e29b-41d4-a716-446655441111",
            "artistName": "Jane Smith",
            "type": "featuring"
          }
        ],
        "mainGenre": [
          "Pop",
          "Rock"
        ],
        "subGenre": [
          "Alternative"
        ],
        "contributors": {
          "producer": [
            "Producer Name"
          ],
          "songwriter": [
            "Writer Name"
          ]
        },
        "media": [
          {
            "cloudId": "550e8400-e29b-41d4-a716-446655440000",
            "cloudUrl": "https://storage.royalti.io/files/audio.mp3",
            "type": "audio",
            "name": "my-track.mp3",
            "isLink": false,
            "releasePath": "tenant123/releases/release456/tracks/track789/file.mp3",
            "metadata": {
              "duration": 213.5,
              "bitrate": "320",
              "sampleRate": "44100",
              "channels": "2",
              "codec": "mp3",
              "fileSize": 1048576,
              "mimeType": "audio/mpeg",
              "processedAt": "2023-11-07T05:31:56Z",
              "linkValidated": true
            }
          }
        ],
        "metadata": {
          "bpm": 120,
          "key": "C Major"
        },
        "explicit": false
      }
    ],
    "owner": {
      "id": "<string>",
      "firstName": "<string>",
      "lastName": "<string>",
      "email": "<string>"
    }
  }
}

GET /releases/

This endpoint retrieves a specific release by its ID, including all tracks and associated data.

Authentication

This endpoint requires authentication. Include your bearer token in the Authorization header.

Path Parameters

ParameterTypeInRequiredDescription
idstringpathāœ…Release ID

Responses

āœ… 200 - Success

āš ļø 401 - Unauthorized

āš ļø 404 - Not Found

āŒ 500 - Internal Server Error

Tags

Release

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Path Parameters

id
string<uuid>
required

Release ID

Response

Success

success
boolean
Example:

true

data
object
⌘I