TIDAL downloads API
The downloads API from TIDAL — 3 operation(s) for downloads.
TIDAL downloads API is one of 65 APIs that TIDAL publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
This API exposes 3 JSON Schema definitions.
Tagged areas include Downloads. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 3 JSON Schemas.
This API exposes 3 operations across 3 paths, and defines 279 schemas. It is described by OpenAPI 3.2.0, at version 1.10.14.
Requests are made against a single base URL, https://openapi.tidal.com/v2.
3 operations
3 paths
279 schemas
3 GET
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 2
TIDAL downloads API declares
2 security schemes
for authenticating requests.
It supports OAuth 2.0 (Authorization_Code_PKCE) using the authorizationCode flow, exposing 12 scopes.
It supports OAuth 2.0 (Client_Credentials) using the clientCredentials flow.
Authorization_Code_PKCE— See https://developer.tidal.com/documentation/authorization/authorization-authorization-codeClient_Credentials— See https://developer.tidal.com/documentation/authorization/authorization-client-credentials
Paths & Operations 3
Across 3 paths, the API surfaces 3 operations — 3 GET. Each is listed below with its method, path, parameters, and response codes.
downloads 3
GET
/downloads
Get multiple downloads.
GET
/downloads/{id}
Get single download.
GET
/downloads/{id}/relationships/owners
Get owners relationship ("to-many").
Schemas 279
The contract defines 279 schemas that model the data the API accepts and returns. The most detailed are ManualArtistClaims_Attributes (21 properties), Tracks_Relationships (18 properties), Tracks_Attributes (18 properties), Albums_Attributes (17 properties). Each schema is shown below with its type and property counts.
UserOfflineMixes_Relationships
object
1 property
ArtistBiographies_Resource_Object
object
4 properties
2 required
Purchases_Relationships
object
2 properties
UserDailyMixes_Attributes
object
Shares_Relationships
object
2 properties
Reactions_Relationships
object
2 properties
SearchResults_Resource_Object
object
4 properties
2 required
Credits_Resource_Object
object
4 properties
2 required
UserRecommendations_Attributes
object
StripeConnections_Relationships
object
1 property
PriceConfigurations_Attributes
object
2 properties
2 required
Comments_Resource_Object
object
4 properties
2 required
Artwork_VisualMetadata
object
Color information extracted from artwork
3 properties
Appreciations_Attributes
object
1 property
1 required
UserCollections_Tracks_Resource_Identifier_Meta
object
1 property
1 required
OfflineTasks_Resource_Object
object
4 properties
2 required
SquareConnections_Attributes
object
4 properties
1 required
File_Upload_Link_Meta
object
metadata for upload link
2 properties
1 required
UsageRules_Resource_Object
object
3 properties
2 required
PlayQueues_Future_Resource_Identifier_Meta
object
3 properties
2 required
UserCollections_Tracks_Resource_Identifier
object
3 properties
2 required
UserCollectionPlaylists_Relationships
object
2 properties
UserCollectionTracks_Items_Multi_Relationship_Data_Document
object
3 properties
1 required
LyricsProvider
object
2 properties
Artworks_Resource_Object
object
4 properties
2 required
UserDailyMixes_Resource_Object
object
4 properties
2 required
Artists_Followers_Resource_Identifier_Meta
object
1 property
UserCollectionTracks_Items_Resource_Identifier_Meta
object
1 property
1 required
Genres_Resource_Object
object
3 properties
2 required
UserCollectionPlaylists_Items_Multi_Relationship_Data_Document
object
3 properties
1 required
Purchases_Resource_Object
object
4 properties
2 required
ProviderProductInfos_Attributes
object
4 properties
1 required
UserCollectionAlbums_Items_Resource_Identifier_Meta
object
1 property
1 required
UserCollectionPlaylists_Attributes
object
UserNewReleaseMixes_Relationships
object
1 property
UserCollectionAlbums_Items_Resource_Identifier
object
3 properties
2 required
Reactions_Attributes
object
2 properties
2 required
External_Link_Meta
object
metadata about an external link
1 property
1 required
UserCollectionVideos_Items_Resource_Identifier
object
3 properties
2 required
ContentClaims_Resource_Object
object
4 properties
2 required
UserCollections_Videos_Resource_Identifier_Meta
object
1 property
1 required
Users_Attributes
object
7 properties
2 required
UserCollectionArtists_Resource_Object
object
4 properties
2 required
Credits_Attributes
object
2 properties
2 required
UserCollections_Albums_Multi_Relationship_Data_Document
object
3 properties
1 required
UserReports_Resource_Object
object
3 properties
2 required
PlayQueues_Attributes
object
4 properties
4 required
ProviderOwners_Attributes
object
1 property
1 required
Purchases_Attributes
object
2 properties
2 required
ArtistClaims_Relationships
object
3 properties
Downloads_Multi_Resource_Data_Document
object
3 properties
2 required
TrackFiles_Resource_Object
object
3 properties
2 required
TrackStatistics_Resource_Object
object
4 properties
2 required
UserDailyMixes_Relationships
object
1 property
ManualArtistClaims_Resource_Object
object
3 properties
2 required
Links
object
3 properties
1 required
PlayQueues_Relationships
object
4 properties
Download_Link
object
2 properties
2 required
Artists_Following_Resource_Identifier
object
3 properties
2 required
TrackInfo
object
3 properties
1 required
External_Link
object
2 properties
2 required
Lyrics_Resource_Object
object
4 properties
2 required
UserCollectionArtists_Relationships
object
2 properties
Artwork_File_Meta
object
Metadata about an artwork file
2 properties
2 required
PlayQueues_Past_Resource_Identifier
object
3 properties
2 required
Download_Link_Meta
object
Metadata for download link
1 property
Installations_OfflineInventory_Resource_Identifier
object
3 properties
2 required
UserCollectionFolders_Items_Multi_Relationship_Data_Document
object
3 properties
1 required
Downloads_Single_Resource_Data_Document
object
3 properties
2 required
Albums_SuggestedCoverArts_Resource_Identifier
object
3 properties
2 required
UserCollections_Artists_Resource_Identifier_Meta
object
1 property
1 required
SearchSuggestions_Suggestions
object
Suggested search queries
2 properties
1 required
SearchSuggestions_Relationships
object
2 properties
UserCollectionArtists_Items_Resource_Identifier
object
3 properties
2 required
UserCollectionFolders_Items_Resource_Identifier_Meta
object
1 property
1 required
ArtistBiographies_Attributes
object
3 properties
2 required
UserCollections_Albums_Resource_Identifier
object
3 properties
2 required
UserCollectionVideos_Items_Resource_Identifier_Meta
object
1 property
1 required
ContentClaims_Attributes
object
4 properties
4 required
SearchSuggestions_History
object
Suggestions from search history. Deprecated — use the history relationship instead. Will be deleted shortly.
2 properties
1 required
UserCollectionArtists_Items_Resource_Identifier_Meta
object
1 property
1 required
Artworks_Attributes
object
4 properties
2 required
ProviderOwners_Resource_Object
object
4 properties
2 required
PlayQueues_Current_Single_Relationship_Data_Document
object
3 properties
1 required
Playlists_Items_Resource_Identifier_Meta
object
2 properties
SearchSuggestions_Resource_Object
object
4 properties
2 required
Artists_TrackProviders_Resource_Identifier
object
3 properties
2 required
Artwork_SourceFile
object
Artwork source file
4 properties
4 required
UserCollectionSaveForLaters_Relationships
object
2 properties
UserCollectionSaveForLaters_Items_Resource_Identifier
object
3 properties
2 required
UserCollectionFolders_Attributes
object
5 properties
4 required
Artists_Followers_Multi_Relationship_Data_Document
object
3 properties
1 required
Playlists_Resource_Object
object
4 properties
2 required
Users_Resource_Object
object
3 properties
2 required
Playlists_Relationships
object
6 properties
Albums_SuggestedCoverArts_Multi_Relationship_Data_Document_Meta
object
1 property
UserCollections_Relationships
object
6 properties
Installations_OfflineInventory_Multi_Relationship_Data_Document
object
3 properties
1 required
UserCollectionTracks_Resource_Object
object
4 properties
2 required
AudioNormalizationData
object
Track normalization data
2 properties
DynamicModules_Attributes
object
6 properties
4 required
UserCollectionAlbums_Relationships
object
2 properties
DspSharingLinks_Relationships
object
1 property
AcceptedTerms_Relationships
object
2 properties
Artists_Following_Multi_Relationship_Data_Document
object
3 properties
1 required
PlayQueues_Past_Resource_Identifier_Meta
object
3 properties
2 required
Lyrics_Attributes
object
5 properties
1 required
Albums_SuggestedCoverArts_Resource_Identifier_Meta
object
2 properties
2 required
UserCollections_Albums_Resource_Identifier_Meta
object
1 property
1 required
Downloads_Relationships
object
1 property
Albums_Items_Resource_Identifier
object
3 properties
2 required
TracksMetadataStatus_Resource_Object
object
3 properties
2 required
TrackManifests_Resource_Object
object
3 properties
2 required
UserCollections_Attributes
object
TrackSourceFiles_Relationships
object
1 property
Albums_Resource_Object
object
4 properties
2 required
Highlight
object
2 properties
SavedShares_Attributes
object
1 property
1 required
PlayQueues_Current_Resource_Identifier_Meta
object
3 properties
2 required
DspSharingLinks_Resource_Object
object
4 properties
2 required
Clients_Resource_Object
object
4 properties
2 required
UserCollections_Playlists_Resource_Identifier
object
3 properties
2 required
UserCollectionArtists_Items_Multi_Relationship_Data_Document
object
3 properties
1 required
Artists_Resource_Object
object
4 properties
2 required
UserCollectionVideos_Relationships
object
2 properties
TemporaryUserTokens_Attributes
object
TemporaryUserTokens_Relationships
object
1 property
OfflineTasks_Attributes
object
4 properties
4 required
Credits_Relationships
object
2 properties
Albums_Attributes
object
17 properties
9 required
Genres_Attributes
object
1 property
1 required
VideoManifests_Attributes
object
4 properties
DynamicModules_Relationships
object
1 property
UserCollections_Videos_Resource_Identifier
object
3 properties
2 required
LegacySource
object
2 properties
2 required
ArtistBiographies_Relationships
object
1 property
StripeDashboardLinks_Attributes
object
1 property
Videos_Resource_Object
object
4 properties
2 required
Clients_Relationships
object
1 property
UserCollectionVideos_Attributes
object
2 properties
1 required
Lyrics_Relationships
object
2 properties
Artworks_Relationships
object
1 property
Installations_Attributes
object
2 properties
2 required
UserDataExportRequests_Attributes
object
1 property
1 required
ArtistRoles_Attributes
object
1 property
1 required
UserCollectionTracks_Attributes
object
2 properties
1 required
UserReports_Attributes
object
2 properties
2 required
Shares_Resource_Object
object
4 properties
2 required
File_Status
object
File status
2 properties
2 required
PriceConfigurations_Resource_Object
object
3 properties
2 required
PlayQueues_Future_Resource_Identifier
object
3 properties
2 required
UserCollections_Tracks_Multi_Relationship_Data_Document
object
3 properties
1 required
UserCollections_Videos_Multi_Relationship_Data_Document
object
3 properties
1 required
Multi_Relationship_Data_Document
object
2 properties
1 required
UserCollections_Artists_Multi_Relationship_Data_Document
object
3 properties
1 required
Providers_Attributes
object
1 property
1 required
TrackStatistics_Attributes
object
2 properties
2 required
AcceptedTerms_Resource_Object
object
4 properties
2 required
Downloads_Resource_Object
object
4 properties
2 required
AlbumStatistics_Resource_Object
object
4 properties
2 required
Artists_Followers_Resource_Identifier
object
3 properties
2 required
UserCollectionSaveForLaters_Items_Multi_Relationship_Data_Document
object
3 properties
1 required
Artists_Attributes
object
8 properties
2 required
ProviderOwners_Relationships
object
2 properties
UserOfflineMixes_Attributes
object
File_Upload_Link
object
Upload link
2 properties
2 required
TrackSourceFiles_Resource_Object
object
4 properties
2 required
Shares_Attributes
object
3 properties
2 required
ArtistClaims_Attributes
object
6 properties
3 required
UserCollectionSaveForLaters_Attributes
object
2 properties
1 required
ThirdPartyLyricsProvider
object
3 required
UserCollectionPlaylists_Items_Resource_Identifier
object
3 properties
2 required
UserRecommendations_Resource_Object
object
4 properties
2 required
Providers_Resource_Object
object
3 properties
2 required
SearchResults_Attributes
object
2 properties
1 required
Playlists_Items_Multi_Relationship_Data_Document
object
3 properties
1 required
Installations_Relationships
object
2 properties
Albums_SuggestedCoverArts_Multi_Relationship_Data_Document
object
4 properties
1 required
LegacyBarcodeId
object
List of UPCs retrieved from the DSP
1 property
UserCollectionVideos_Items_Multi_Relationship_Data_Document
object
3 properties
1 required
Comments_Relationships
object
3 properties
UserCollections_Playlists_Multi_Relationship_Data_Document
object
3 properties
1 required
DynamicPages_Relationships
object
2 properties
Copyright
object
Copyright information
1 property
1 required
Terms_Attributes
object
4 properties
4 required
Artists_Followers_Resource_Meta_ViewerContext
object
Optional context about the relationship
2 properties
UserCollectionFolders_Relationships
object
2 properties
Albums_Relationships
object
13 properties
TrackFiles_Attributes
object
5 properties
Tracks_Relationships
object
18 properties
UserCollectionSaveForLaters_Items_Resource_Identifier_Meta
object
1 property
1 required
Link_Object
object
A JSON:API link object
1 property
DrmData
object
DRM data. Absence implies no DRM.
4 properties
TemporaryUserTokens_Resource_Object
object
4 properties
2 required
StripeConnections_Resource_Object
object
4 properties
2 required
UserCollectionPlaylists_Resource_Object
object
4 properties
2 required
Downloads_Multi_Relationship_Data_Document
object
3 properties
1 required
UserCollectionAlbums_Resource_Object
object
4 properties
2 required
DspSharingLinks_Attributes
object
4 properties
DynamicPages_Attributes
object
2 properties
2 required
PlayQueues_Past_Multi_Relationship_Data_Document
object
3 properties
1 required
ArtistRoles_Resource_Object
object
3 properties
2 required
Terms_Resource_Object
object
3 properties
2 required
Videos_Attributes
object
10 properties
5 required
UserNewReleaseMixes_Attributes
object
Tracks_Attributes
object
18 properties
8 required
UserDataExportRequests_Resource_Object
object
3 properties
2 required
UserNewReleaseMixes_Resource_Object
object
4 properties
2 required
PlayQueues_Resource_Object
object
4 properties
2 required
Installations_Resource_Object
object
4 properties
2 required
Links_Meta
object
Non-standard meta information for links
1 property
1 required
TrackManifests_Attributes
object
8 properties
Playlists_Attributes
object
11 properties
8 required
DynamicPages_Resource_Object
object
4 properties
2 required
Included
array
Playlists_Items_Resource_Identifier
object
3 properties
2 required
Comments_Attributes
object
8 properties
6 required
UserDiscoveryMixes_Attributes
object
Single_Relationship_Data_Document
object
2 properties
1 required
Albums_Items_Multi_Relationship_Data_Document
object
3 properties
1 required
ProviderProductInfos_Relationships
object
2 properties
UserDiscoveryMixes_Relationships
object
1 property
UserCollections_Artists_Resource_Identifier
object
3 properties
2 required
ArtistClaims_Resource_Object
object
4 properties
2 required
UserCollectionTracks_Items_Resource_Identifier
object
3 properties
2 required
UserCollections_Resource_Object
object
4 properties
2 required
Installations_OfflineInventory_Resource_Identifier_Meta
object
1 property
1 required
PlayQueues_Future_Multi_Relationship_Data_Document
object
3 properties
1 required
Resource_Identifier
object
2 properties
2 required
Tracks_Resource_Object
object
4 properties
2 required
TrackSourceFiles_Attributes
object
4 properties
4 required
Artists_Relationships
object
12 properties
UserCollectionArtists_Attributes
object
2 properties
1 required
AlbumStatistics_Attributes
object
3 properties
2 required
OfflineTasks_Relationships
object
3 properties
Clients_Attributes
object
8 properties
2 required
TrackStatistics_Relationships
object
1 property
SearchResults_Relationships
object
6 properties
TidalLyricsProvider
object
Artists_TrackProviders_Multi_Relationship_Data_Document
object
3 properties
1 required
PlayQueues_Current_Resource_Identifier
object
3 properties
2 required
UserDiscoveryMixes_Resource_Object
object
4 properties
2 required
UserCollectionFolders_Resource_Object
object
4 properties
2 required
SquareConnections_Resource_Object
object
3 properties
2 required
Albums_Items_Resource_Identifier_Meta
object
2 properties
2 required
SearchSuggestions_Attributes
object
3 properties
1 required
AcceptedTerms_Attributes
object
1 property
1 required
ProviderProductInfos_Resource_Object
object
4 properties
2 required
StripeConnections_Attributes
object
4 properties
1 required
DynamicModules_Resource_Object
object
4 properties
2 required
ManualArtistClaims_Attributes
object
21 properties
4 required
Videos_Relationships
object
9 properties
SearchHistoryEntries_Attributes
object
2 properties
2 required
UserCollectionAlbums_Items_Multi_Relationship_Data_Document
object
3 properties
1 required
UsageRules_Attributes
object
6 properties
1 required
StripeDashboardLinks_Resource_Object
object
4 properties
2 required
Reactions_Resource_Object
object
4 properties
2 required
Artists_TrackProviders_Resource_Identifier_Meta
object
1 property
1 required
TracksMetadataStatus_Attributes
object
1 property
1 required
Appreciations_Resource_Object
object
3 properties
2 required
UserCollections_Playlists_Resource_Identifier_Meta
object
1 property
1 required
Artwork_File
object
Artwork files
2 properties
1 required
UserCollectionSaveForLaters_Resource_Object
object
4 properties
2 required
UserCollectionFolders_Items_Resource_Identifier
object
3 properties
2 required
UserRecommendations_Relationships
object
4 properties
AlbumStatistics_Relationships
object
1 property
UserCollectionVideos_Resource_Object
object
4 properties
2 required
VideoManifests_Resource_Object
object
3 properties
2 required
Artists_Following_Resource_Identifier_Meta
object
1 property
SearchSuggestions_Highlights
object
2 properties
2 required
UserCollectionAlbums_Attributes
object
2 properties
1 required
Downloads_Attributes
object
1 property
SavedShares_Resource_Object
object
3 properties
2 required
ContentClaims_Relationships
object
3 properties
UserCollectionPlaylists_Items_Resource_Identifier_Meta
object
1 property
1 required
StripeDashboardLinks_Relationships
object
1 property
UserCollectionTracks_Relationships
object
2 properties
UserOfflineMixes_Resource_Object
object
4 properties
2 required
SearchHistoryEntries_Resource_Object
object
3 properties
2 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from TIDAL 12
Other APIs TIDAL publishes across the network.
TIDAL Playlists API
TIDAL Users API
TIDAL acceptedTerms API
TIDAL albums API
TIDAL albumStatistics API
TIDAL appreciations API
TIDAL artistBiographies API
TIDAL artistClaims API
TIDAL artistRoles API
TIDAL artists API
TIDAL artworks API
TIDAL clients API
#Downloads
Where this information came from
This is an independent, third-party profile of TIDAL downloads API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.