GetSongSmartLinks

Get Song Smart Links

Allows to get the smart links associated with a Song.

Request

URL: /v1/songs/{songId}/smartlinks

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 Smart Link.	Always
storeName	string	The store name.	Always
url	string	The smart link URL.	Always

Content example:

[
    {
        "id": "8038e46d-c3c2-4197-8f5a-7bf9c2db98f4",
        "storeName": "Spotify",
        "url": "https://open.spotify.com/album/0MeKAJYCC9DCZnt4Nz6HLV"
    },
    {
        "id": "aafd4ce4-47fe-4ccd-94b4-4a6952e9a0fd",
        "storeName": "Amazon Prime Music",
        "url": "https://music.amazon.com/albums/B0DK2JMVL4?ref=dm_ff_amazonmusic.3p"
    },
    {
        "id": "80c7c027-d8d5-496f-bdae-b70444c3aa41",
        "storeName": "Apple Music",
        "url": "https://geo.music.apple.com/us/album/1773721964?app=music&ls=1"
    }
]

❌ Error Responses

1. Unauthorized

Code: 401 UNAUTHORIZED

Condition: If {accessToken} is invalid or expired.

2. 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 Song

Get Songs

Get Song Count

Delete Song

Upload Song Audio

Process Song Stream Token Agreement

Get Song Genres

Get Song Genre Count