GetSong

Get Song

Allows to get a Song.

Request

URL: /v1/songs/{songId}

Method: GET

Path Parameters:

Parameter	Type	Description
songId	string	UUID of the Song to retrieve.

Query Parameters: None

Headers:

Authorization: Bearer {accessToken}

Accept: application/json

✅ Success Response

Code: 200 OK

Headers:

Content-Type: application/json

Content:

Field	Type	Description	Condition
id	string	UUID of the Song.	Always
archived	boolean	Song archive indicator.	Always
ownerId	string	UUID of the Song owner (creator).	Always
createdAt	string	Date and time when the Song was created (ISO-8601 format).	Always
title	string	Song title.	Always
genres	string array	Song genres.	Always
moods	string array	Song moods.	Only if available
coverArtUrl	string	Valid URL of cover art picture file.	Only if available
lyricsUrl	string	Valid URL of song lyrics file.	Only if available
description	string	Song description.	Only if available
album	string	Song album.	Only if available
track	integer	Song track.	Only if available
language	string	Song language.	Only if available
coverRemixSample	boolean	Indicates if the Song is a Cover, Remix or Sample.	Always
compositionCopyrightOwner	string	Song composition copyright owner.	Only if available
compositionCopyrightYear	integer	Song composition copyright year.	Only if available
phonographicCopyrightOwner	string	Song phonographic copyright owner.	Only if available
phonographicCopyrightYear	integer	Song phonographic copyright year.	Only if available
parentalAdvisory	string	Song parental advisory.	Only if available
barcodeType	string	Song barcode type. Valid values are: Upc, Ean and Jan.	Only if available
barcodeNumber	string	Song barcode number.	Only if available
isrc	string	International Standard Recording Code (ISRC).	Only if available
iswc	string	International Standard Musical Work Code (ISWC).	Only if available
ipis	string array	Interested Party Information (IPIS) Numbers.	Only if available
releaseDate	string	Song release date (ISO-8601 format)	Only if available
publicationDate	string	Song publication date (ISO-8601 format)	Only if available
duration	integer	Song duration in milliseconds.	Only if available
streamUrl	string	Song streaming URL.	Only if available
nftPolicyId	string	Song NFT Policy ID.	Only if available
nftName	string	Song NFT Name.	Only if available
audioEncodingStatus	string	Song audio encoding status. Valid values are: NotStarted, Started, Completed & Failed	Always
mintingStatus	string	Song minting status. Valid values are: Undistributed, StreamTokenAgreementApproved, MintingPaymentRequested, MintingPaymentReceived, AwaitingAudioEncoding, AwaitingCollaboratorApproval, ReadyToDistribute, SubmittedForDistribution, Distributed, Declined, Pending & Minted	Always
marketplaceStatus	string	Song marketplace status. Valid valid values are: NotSelling & Selling.	Always

Content example:

{
    "id": "7bd2862f-8deb-4814-8943-156d9dab80dd",
    "archived": false,
    "ownerId": "842f5460-76f8-41d8-add9-d043a7a381de",
    "createdAt": "2022-04-22T20:47:55.738918",
    "title": "Blinding Lights",
    "genres": ["Synthwave", "Synthpop"],
    "moods": ["Cool", "Upbeat"],
    "coverArtUrl": "https://www.example.com/bindinglights/cover.png",
    "lyricsUrl": "https://www.example.com/bindinglights/lyrics.txt",
    "description": "Song by The Weeknd",
    "coverRemixSample": false,
    "compositionCopyrightOwner": "© The Weeknd",
    "compositionCopyrightYear": 2022
    "duration": 132202,    
    "streamUrl": "https://www.example.com/bindinglights/blinding_lights.m4a",
    "nftPolicyId": "11123344555",
    "nftPolicyName": "Blinding Lights NFT",
    "audioEncodingStatus": "Completed",
    "mintingStatus": "Minted",
    "marketplaceStatus": "Selling"
}

❌ Error Responses

1. Unauthorized

Code: 401 UNAUTHORIZED

Condition: If {accessToken} is invalid or expired.

2. Not Found

Code: 404 NOT FOUND

Condition: If the specified Song is not found.

Headers:

Content-Type: application/json

Content example:

{
    "code": 404,
    "description": "Not Found",
    "cause": "Entity SongEntity, id=d0907e3d-a9a7-43b1-93dc-f3b0ee929021 not found in the database"
}

3. Unprocessable Entity

Code: 422 UNPROCESSABLE ENTITY

Condition: If {songId} is malformed.

Headers:

Content-Type: application/json

Content example:

{
    "code": 422,
    "description": "Unprocessable Entity",
    "cause": "Invalid UUID string: 123456789"
}

See Also

Post Song (Add New Song)

Patch Song (Update Song)

Get Songs

Get Song Count

Delete Song

Upload Song Audio

Process Song Stream Token Agreement

Get Song Smart Links

Get Song Genres

Get Song Genre Count