TIDAL usageRules API
The usageRules API from TIDAL — 2 operation(s) for usagerules.
TIDAL usageRules 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 usageRules. 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 2 paths, and defines 284 schemas. It is described by OpenAPI 3.0.1, at version 1.10.14.
Requests are made against a single base URL, https://openapi.tidal.com/v2.
3 operations
2 paths
284 schemas
2 GET1 POST
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 2
TIDAL usageRules 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 2 paths, the API surfaces 3 operations — 2 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.
usageRules 3
GET
/usageRules
Get multiple usageRules.
POST
/usageRules
Create single usageRule.
GET
/usageRules/{id}
Get single usageRule.
Schemas 284
The contract defines 284 schemas that model the data the API accepts and returns. The most detailed are ManualArtistClaims_Attributes (21 properties), Tracks_Attributes (18 properties), Tracks_Relationships (18 properties), Albums_Attributes (17 properties). Each schema is shown below with its type and property counts.
TrackFiles_Attributes
object
5 properties
PlayQueues_Future_Multi_Relationship_Data_Document
object
3 properties
1 required
UserCollectionArtists_Attributes
object
2 properties
1 required
UserCollectionAlbums_Items_Multi_Relationship_Data_Document
object
3 properties
1 required
TrackSourceFiles_Relationships
object
1 property
ProviderProductInfos_Resource_Object
object
4 properties
2 required
Artists_Followers_Resource_Identifier_Meta
object
1 property
UserCollectionTracks_Attributes
object
2 properties
1 required
Terms_Attributes
object
4 properties
4 required
Lyrics_Attributes
object
5 properties
1 required
DynamicPages_Relationships
object
2 properties
Albums_SuggestedCoverArts_Resource_Identifier
object
3 properties
2 required
Artists_Followers_Multi_Relationship_Data_Document
object
3 properties
1 required
UsageRulesCreateOperation_Payload_Subject
object
2 properties
2 required
AlbumStatistics_Resource_Object
object
4 properties
2 required
Comments_Relationships
object
3 properties
UserOfflineMixes_Resource_Object
object
4 properties
2 required
SearchSuggestions_Suggestions
object
Suggested search queries
2 properties
1 required
UserOfflineMixes_Relationships
object
1 property
DspSharingLinks_Resource_Object
object
4 properties
2 required
ProviderProductInfos_Attributes
object
4 properties
1 required
UserCollections_Tracks_Resource_Identifier_Meta
object
1 property
1 required
UserCollections_Artists_Resource_Identifier_Meta
object
1 property
1 required
UserDailyMixes_Resource_Object
object
4 properties
2 required
UserCollectionVideos_Attributes
object
2 properties
1 required
AcceptedTerms_Resource_Object
object
4 properties
2 required
Videos_Resource_Object
object
4 properties
2 required
SearchResults_Attributes
object
2 properties
1 required
External_Link
object
2 properties
2 required
UsageRules_Attributes
object
6 properties
1 required
TemporaryUserTokens_Resource_Object
object
4 properties
2 required
Downloads_Resource_Object
object
4 properties
2 required
TrackStatistics_Resource_Object
object
4 properties
2 required
Artwork_File
object
Artwork files
2 properties
1 required
Links
object
3 properties
1 required
AudioNormalizationData
object
Track normalization data
2 properties
UserCollectionArtists_Items_Resource_Identifier
object
3 properties
2 required
UserCollectionFolders_Attributes
object
5 properties
4 required
Tracks_Attributes
object
18 properties
8 required
UserDiscoveryMixes_Relationships
object
1 property
PlayQueues_Past_Resource_Identifier
object
3 properties
2 required
PlayQueues_Resource_Object
object
4 properties
2 required
PlayQueues_Future_Resource_Identifier
object
3 properties
2 required
UserCollectionTracks_Resource_Object
object
4 properties
2 required
Albums_Relationships
object
13 properties
UserCollectionTracks_Relationships
object
2 properties
Artists_TrackProviders_Multi_Relationship_Data_Document
object
3 properties
1 required
Artwork_File_Meta
object
Metadata about an artwork file
2 properties
2 required
Albums_Resource_Object
object
4 properties
2 required
ProviderProductInfos_Relationships
object
2 properties
Playlists_Resource_Object
object
4 properties
2 required
UserCollectionPlaylists_Items_Resource_Identifier_Meta
object
1 property
1 required
LegacyBarcodeId
object
List of UPCs retrieved from the DSP
1 property
UserCollectionArtists_Relationships
object
2 properties
Credits_Attributes
object
2 properties
2 required
UsageRules_Multi_Resource_Data_Document
object
3 properties
2 required
Copyright
object
Copyright information
1 property
1 required
UserCollectionFolders_Relationships
object
2 properties
Appreciations_Resource_Object
object
3 properties
2 required
Playlists_Items_Multi_Relationship_Data_Document
object
3 properties
1 required
PlayQueues_Future_Resource_Identifier_Meta
object
3 properties
2 required
TrackSourceFiles_Resource_Object
object
4 properties
2 required
PriceConfigurations_Attributes
object
2 properties
2 required
Link_Object
object
A JSON:API link object
1 property
OfflineTasks_Resource_Object
object
4 properties
2 required
UsageRules_Resource_Object
object
3 properties
2 required
Terms_Resource_Object
object
3 properties
2 required
Shares_Relationships
object
2 properties
UserCollectionAlbums_Items_Resource_Identifier_Meta
object
1 property
1 required
File_Status
object
File status
2 properties
2 required
Tracks_Resource_Object
object
4 properties
2 required
UserCollections_Videos_Resource_Identifier
object
3 properties
2 required
UserCollectionSaveForLaters_Items_Resource_Identifier
object
3 properties
2 required
Users_Resource_Object
object
3 properties
2 required
Installations_OfflineInventory_Resource_Identifier_Meta
object
1 property
1 required
DspSharingLinks_Relationships
object
1 property
SquareConnections_Resource_Object
object
3 properties
2 required
ManualArtistClaims_Resource_Object
object
3 properties
2 required
Multi_Relationship_Data_Document
object
2 properties
1 required
Artists_Followers_Resource_Identifier
object
3 properties
2 required
TrackManifests_Attributes
object
8 properties
Lyrics_Relationships
object
2 properties
Downloads_Relationships
object
1 property
UserCollectionVideos_Items_Multi_Relationship_Data_Document
object
3 properties
1 required
UserCollections_Albums_Resource_Identifier
object
3 properties
2 required
DrmData
object
DRM data. Absence implies no DRM.
4 properties
Albums_Items_Resource_Identifier_Meta
object
2 properties
2 required
AcceptedTerms_Relationships
object
2 properties
ManualArtistClaims_Attributes
object
21 properties
4 required
SearchSuggestions_Resource_Object
object
4 properties
2 required
TrackFiles_Resource_Object
object
3 properties
2 required
UserCollectionFolders_Items_Resource_Identifier_Meta
object
1 property
1 required
ArtistBiographies_Resource_Object
object
4 properties
2 required
ArtistClaims_Relationships
object
3 properties
Clients_Relationships
object
1 property
UserCollections_Resource_Object
object
4 properties
2 required
SearchHistoryEntries_Attributes
object
2 properties
2 required
UserNewReleaseMixes_Resource_Object
object
4 properties
2 required
UserCollections_Playlists_Resource_Identifier
object
3 properties
2 required
Genres_Resource_Object
object
3 properties
2 required
Comments_Resource_Object
object
4 properties
2 required
UserReports_Attributes
object
2 properties
2 required
UserCollectionFolders_Resource_Object
object
4 properties
2 required
ProviderOwners_Resource_Object
object
4 properties
2 required
UserCollectionSaveForLaters_Attributes
object
2 properties
1 required
Artists_TrackProviders_Resource_Identifier_Meta
object
1 property
1 required
TrackInfo
object
3 properties
1 required
Artists_Attributes
object
8 properties
2 required
ArtistClaims_Resource_Object
object
4 properties
2 required
SavedShares_Resource_Object
object
3 properties
2 required
Tracks_Relationships
object
18 properties
LyricsProvider
object
2 properties
ContentClaims_Relationships
object
3 properties
UserCollectionPlaylists_Items_Multi_Relationship_Data_Document
object
3 properties
1 required
SearchSuggestions_History
object
Suggestions from search history. Deprecated — use the history relationship instead. Will be deleted shortly.
2 properties
1 required
TracksMetadataStatus_Attributes
object
1 property
1 required
Purchases_Attributes
object
2 properties
2 required
Genres_Attributes
object
1 property
1 required
TrackSourceFiles_Attributes
object
4 properties
4 required
StripeConnections_Relationships
object
1 property
UserRecommendations_Resource_Object
object
4 properties
2 required
UserCollectionVideos_Items_Resource_Identifier
object
3 properties
2 required
VideoManifests_Attributes
object
4 properties
Playlists_Items_Resource_Identifier_Meta
object
2 properties
Links_Meta
object
Non-standard meta information for links
1 property
1 required
VideoManifests_Resource_Object
object
3 properties
2 required
Artists_Resource_Object
object
4 properties
2 required
UserCollectionVideos_Items_Resource_Identifier_Meta
object
1 property
1 required
DynamicModules_Resource_Object
object
4 properties
2 required
ProviderOwners_Attributes
object
1 property
1 required
UserCollections_Relationships
object
6 properties
Credits_Relationships
object
2 properties
AcceptedTerms_Attributes
object
1 property
1 required
Installations_Relationships
object
2 properties
UserCollections_Artists_Multi_Relationship_Data_Document
object
3 properties
1 required
Download_Link
object
2 properties
2 required
UserCollectionPlaylists_Resource_Object
object
4 properties
2 required
UserRecommendations_Attributes
object
Artists_Following_Resource_Identifier
object
3 properties
2 required
Albums_Items_Multi_Relationship_Data_Document
object
3 properties
1 required
StripeConnections_Resource_Object
object
4 properties
2 required
UsageRulesCreateOperation_Payload
object
1 property
1 required
Reactions_Resource_Object
object
4 properties
2 required
File_Upload_Link
object
Upload link
2 properties
2 required
TemporaryUserTokens_Relationships
object
1 property
SearchHistoryEntries_Resource_Object
object
3 properties
2 required
SearchSuggestions_Highlights
object
2 properties
2 required
Playlists_Attributes
object
11 properties
8 required
ArtistRoles_Resource_Object
object
3 properties
2 required
DynamicModules_Relationships
object
1 property
TrackStatistics_Relationships
object
1 property
Artwork_SourceFile
object
Artwork source file
4 properties
4 required
StripeDashboardLinks_Relationships
object
1 property
SearchResults_Relationships
object
6 properties
Playlists_Items_Resource_Identifier
object
3 properties
2 required
Installations_OfflineInventory_Resource_Identifier
object
3 properties
2 required
Albums_SuggestedCoverArts_Resource_Identifier_Meta
object
2 properties
2 required
UserCollectionSaveForLaters_Relationships
object
2 properties
Installations_Resource_Object
object
4 properties
2 required
StripeDashboardLinks_Attributes
object
1 property
UserCollectionSaveForLaters_Items_Resource_Identifier_Meta
object
1 property
1 required
Reactions_Relationships
object
2 properties
UserDailyMixes_Attributes
object
External_Link_Meta
object
metadata about an external link
1 property
1 required
Download_Link_Meta
object
Metadata for download link
1 property
UserCollectionTracks_Items_Resource_Identifier_Meta
object
1 property
1 required
Users_Attributes
object
7 properties
2 required
UserCollectionPlaylists_Items_Resource_Identifier
object
3 properties
2 required
Albums_SuggestedCoverArts_Multi_Relationship_Data_Document_Meta
object
1 property
PlayQueues_Current_Resource_Identifier
object
3 properties
2 required
UsageRulesCreateOperation_Payload_Data_Relationships
object
1 property
1 required
File_Upload_Link_Meta
object
metadata for upload link
2 properties
1 required
PlayQueues_Current_Resource_Identifier_Meta
object
3 properties
2 required
UserCollections_Tracks_Resource_Identifier
object
3 properties
2 required
UserCollectionArtists_Items_Resource_Identifier_Meta
object
1 property
1 required
Highlight
object
2 properties
Shares_Attributes
object
3 properties
2 required
SquareConnections_Attributes
object
4 properties
1 required
PlayQueues_Past_Resource_Identifier_Meta
object
3 properties
2 required
UserReports_Resource_Object
object
3 properties
2 required
Artworks_Attributes
object
4 properties
2 required
UserCollectionPlaylists_Attributes
object
Reactions_Attributes
object
2 properties
2 required
Artists_Following_Multi_Relationship_Data_Document
object
3 properties
1 required
UserCollections_Playlists_Resource_Identifier_Meta
object
1 property
1 required
PlayQueues_Past_Multi_Relationship_Data_Document
object
3 properties
1 required
TemporaryUserTokens_Attributes
object
Included
array
ArtistBiographies_Attributes
object
3 properties
2 required
PlayQueues_Attributes
object
4 properties
4 required
SearchSuggestions_Attributes
object
3 properties
1 required
SearchSuggestions_Relationships
object
2 properties
Single_Relationship_Data_Document
object
2 properties
1 required
UserNewReleaseMixes_Attributes
object
PlayQueues_Current_Single_Relationship_Data_Document
object
3 properties
1 required
ArtistClaims_Attributes
object
6 properties
3 required
Videos_Relationships
object
9 properties
UserCollectionArtists_Items_Multi_Relationship_Data_Document
object
3 properties
1 required
Appreciations_Attributes
object
1 property
1 required
Artworks_Resource_Object
object
4 properties
2 required
OfflineTasks_Relationships
object
3 properties
ContentClaims_Attributes
object
4 properties
4 required
UserCollectionSaveForLaters_Resource_Object
object
4 properties
2 required
UserCollectionAlbums_Resource_Object
object
4 properties
2 required
DynamicPages_Attributes
object
2 properties
2 required
Lyrics_Resource_Object
object
4 properties
2 required
Artwork_VisualMetadata
object
Color information extracted from artwork
3 properties
ArtistRoles_Attributes
object
1 property
1 required
Albums_SuggestedCoverArts_Multi_Relationship_Data_Document
object
4 properties
1 required
Installations_Attributes
object
2 properties
2 required
UsageRulesCreateOperation_Payload_Data_Attributes
object
6 properties
UserNewReleaseMixes_Relationships
object
1 property
StripeDashboardLinks_Resource_Object
object
4 properties
2 required
UserDiscoveryMixes_Attributes
object
UserCollections_Albums_Multi_Relationship_Data_Document
object
3 properties
1 required
UserCollectionSaveForLaters_Items_Multi_Relationship_Data_Document
object
3 properties
1 required
Artists_Followers_Resource_Meta_ViewerContext
object
Optional context about the relationship
2 properties
TracksMetadataStatus_Resource_Object
object
3 properties
2 required
Credits_Resource_Object
object
4 properties
2 required
Resource_Identifier
object
2 properties
2 required
UserCollections_Albums_Resource_Identifier_Meta
object
1 property
1 required
Shares_Resource_Object
object
4 properties
2 required
UserDiscoveryMixes_Resource_Object
object
4 properties
2 required
Purchases_Resource_Object
object
4 properties
2 required
LegacySource
object
2 properties
2 required
Downloads_Attributes
object
1 property
UserDailyMixes_Relationships
object
1 property
AlbumStatistics_Attributes
object
3 properties
2 required
Artists_Following_Resource_Identifier_Meta
object
1 property
Artists_Relationships
object
12 properties
UserCollectionFolders_Items_Multi_Relationship_Data_Document
object
3 properties
1 required
ContentClaims_Resource_Object
object
4 properties
2 required
ProviderOwners_Relationships
object
2 properties
OfflineTasks_Attributes
object
4 properties
4 required
TidalLyricsProvider
object
Playlists_Relationships
object
6 properties
UserCollectionTracks_Items_Resource_Identifier
object
3 properties
2 required
TrackStatistics_Attributes
object
2 properties
2 required
Providers_Attributes
object
1 property
1 required
SavedShares_Attributes
object
1 property
1 required
UserCollectionArtists_Resource_Object
object
4 properties
2 required
UsageRulesCreateOperation_Payload_Data_Relationships_Subject
object
1 property
1 required
UserCollectionTracks_Items_Multi_Relationship_Data_Document
object
3 properties
1 required
UserRecommendations_Relationships
object
4 properties
PriceConfigurations_Resource_Object
object
3 properties
2 required
TrackManifests_Resource_Object
object
3 properties
2 required
Albums_Attributes
object
17 properties
9 required
UserCollections_Videos_Multi_Relationship_Data_Document
object
3 properties
1 required
Artworks_Relationships
object
1 property
UsageRulesCreateOperation_Payload_Data
object
3 properties
3 required
DynamicModules_Attributes
object
6 properties
4 required
UserDataExportRequests_Attributes
object
1 property
1 required
Comments_Attributes
object
8 properties
6 required
UserCollectionPlaylists_Relationships
object
2 properties
PlayQueues_Relationships
object
4 properties
Installations_OfflineInventory_Multi_Relationship_Data_Document
object
3 properties
1 required
UserCollectionFolders_Items_Resource_Identifier
object
3 properties
2 required
StripeConnections_Attributes
object
4 properties
1 required
UserCollectionVideos_Resource_Object
object
4 properties
2 required
UserCollections_Tracks_Multi_Relationship_Data_Document
object
3 properties
1 required
UserCollections_Playlists_Multi_Relationship_Data_Document
object
3 properties
1 required
UserCollections_Artists_Resource_Identifier
object
3 properties
2 required
UserOfflineMixes_Attributes
object
Clients_Attributes
object
8 properties
2 required
Purchases_Relationships
object
2 properties
UserCollectionAlbums_Relationships
object
2 properties
UserCollectionVideos_Relationships
object
2 properties
SearchResults_Resource_Object
object
4 properties
2 required
ThirdPartyLyricsProvider
object
3 required
UsageRules_Single_Resource_Data_Document
object
3 properties
2 required
UserCollectionAlbums_Items_Resource_Identifier
object
3 properties
2 required
Artists_TrackProviders_Resource_Identifier
object
3 properties
2 required
AlbumStatistics_Relationships
object
1 property
UserDataExportRequests_Resource_Object
object
3 properties
2 required
UserCollections_Attributes
object
Albums_Items_Resource_Identifier
object
3 properties
2 required
Videos_Attributes
object
10 properties
5 required
ArtistBiographies_Relationships
object
1 property
UserCollections_Videos_Resource_Identifier_Meta
object
1 property
1 required
DspSharingLinks_Attributes
object
4 properties
Clients_Resource_Object
object
4 properties
2 required
Providers_Resource_Object
object
3 properties
2 required
UserCollectionAlbums_Attributes
object
2 properties
1 required
DynamicPages_Resource_Object
object
4 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
#usageRules