{ "opencollection": "1.0.0", "info": { "name": "TIDAL Catalog API", "version": "1.10.14" }, "items": [ { "info": { "name": "albumStatistics", "type": "folder" }, "items": [ { "info": { "name": "Get multiple albumStatistics.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/albumStatistics", "params": [ { "name": "include", "value": "owners", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: owners" }, { "name": "filter[id]", "value": "", "type": "query", "description": "List of album IDs (e.g. `251380836`)" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves multiple albumStatistics by available filters, or without if applicable." }, { "info": { "name": "Get single albumStatistic.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/albumStatistics/:id", "params": [ { "name": "id", "value": "123456", "type": "path", "description": "Album statistic id" }, { "name": "include", "value": "owners", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: owners" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves single albumStatistic by id." }, { "info": { "name": "Get owners relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/albumStatistics/:id/relationships/owners", "params": [ { "name": "id", "value": "123456", "type": "path", "description": "Album statistic id" }, { "name": "include", "value": "owners", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: owners" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves owners relationship." } ] }, { "info": { "name": "albums", "type": "folder" }, "items": [ { "info": { "name": "Get multiple albums.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/albums", "params": [ { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "sort", "value": "", "type": "query", "description": "Values prefixed with \"-\" are sorted descending; values without it are sorted ascending." }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "albumStatistics", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: albumStatistics, artists, coverArt, genres, items, owners, priceConfig, providers, replacement, shares, similarAlbums, suggestedCoverArts, usageRules" }, { "name": "filter[barcodeId]", "value": "", "type": "query", "description": "List of barcode IDs (EAN-13 or UPC-A). NOTE: Supplying more than one barcode ID will currently only return one album per barcode ID. (e.g. `196589525444`)" }, { "name": "filter[id]", "value": "", "type": "query", "description": "Album id (e.g. `251380836`)" }, { "name": "filter[owners.id]", "value": "", "type": "query", "description": "User id. Use `me` for the authenticated user" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves multiple albums by available filters, or without if applicable." }, { "info": { "name": "Create single album.", "type": "http" }, "http": { "method": "POST", "url": "https://openapi.tidal.com/v2/albums", "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Creates a new album." }, { "info": { "name": "Get single album.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/albums/:id", "params": [ { "name": "id", "value": "251380836", "type": "path", "description": "Album id" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "albumStatistics", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: albumStatistics, artists, coverArt, genres, items, owners, priceConfig, providers, replacement, shares, similarAlbums, suggestedCoverArts, usageRules" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves single album by id." }, { "info": { "name": "Update single album.", "type": "http" }, "http": { "method": "PATCH", "url": "https://openapi.tidal.com/v2/albums/:id", "params": [ { "name": "id", "value": "251380836", "type": "path", "description": "Album id" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Updates existing album." }, { "info": { "name": "Delete single album.", "type": "http" }, "http": { "method": "DELETE", "url": "https://openapi.tidal.com/v2/albums/:id", "params": [ { "name": "id", "value": "251380836", "type": "path", "description": "Album id" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Deletes existing album." }, { "info": { "name": "Get albumStatistics relationship (\"to-one\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/albums/:id/relationships/albumStatistics", "params": [ { "name": "id", "value": "251380836", "type": "path", "description": "Album id" }, { "name": "include", "value": "albumStatistics", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: albumStatistics" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves albumStatistics relationship." }, { "info": { "name": "Get artists relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/albums/:id/relationships/artists", "params": [ { "name": "id", "value": "251380836", "type": "path", "description": "Album id" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "artists", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: artists" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves artists relationship." }, { "info": { "name": "Get coverArt relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/albums/:id/relationships/coverArt", "params": [ { "name": "id", "value": "251380836", "type": "path", "description": "Album id" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "coverArt", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: coverArt" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves coverArt relationship." }, { "info": { "name": "Update coverArt relationship (\"to-many\").", "type": "http" }, "http": { "method": "PATCH", "url": "https://openapi.tidal.com/v2/albums/:id/relationships/coverArt", "params": [ { "name": "id", "value": "251380836", "type": "path", "description": "Album id" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Updates coverArt relationship." }, { "info": { "name": "Get genres relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/albums/:id/relationships/genres", "params": [ { "name": "id", "value": "251380836", "type": "path", "description": "Album id" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "genres", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: genres" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves genres relationship." }, { "info": { "name": "Get items relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/albums/:id/relationships/items", "params": [ { "name": "id", "value": "251380836", "type": "path", "description": "Album id" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "items", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: items" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves items relationship." }, { "info": { "name": "Update items relationship (\"to-many\").", "type": "http" }, "http": { "method": "PATCH", "url": "https://openapi.tidal.com/v2/albums/:id/relationships/items", "params": [ { "name": "id", "value": "251380836", "type": "path", "description": "Album id" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Updates items relationship." }, { "info": { "name": "Get owners relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/albums/:id/relationships/owners", "params": [ { "name": "id", "value": "251380836", "type": "path", "description": "Album id" }, { "name": "include", "value": "owners", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: owners" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves owners relationship." }, { "info": { "name": "Get priceConfig relationship (\"to-one\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/albums/:id/relationships/priceConfig", "params": [ { "name": "id", "value": "251380836", "type": "path", "description": "Album id" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "priceConfig", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: priceConfig" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves priceConfig relationship." }, { "info": { "name": "Get providers relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/albums/:id/relationships/providers", "params": [ { "name": "id", "value": "251380836", "type": "path", "description": "Album id" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "providers", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: providers" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves providers relationship." }, { "info": { "name": "Get replacement relationship (\"to-one\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/albums/:id/relationships/replacement", "params": [ { "name": "id", "value": "251380836", "type": "path", "description": "Album id" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "replacement", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: replacement" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves replacement relationship." }, { "info": { "name": "Get shares relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/albums/:id/relationships/shares", "params": [ { "name": "id", "value": "251380836", "type": "path", "description": "Album id" }, { "name": "include", "value": "shares", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: shares" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves shares relationship." }, { "info": { "name": "Get similarAlbums relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/albums/:id/relationships/similarAlbums", "params": [ { "name": "id", "value": "251380836", "type": "path", "description": "Album id" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "similarAlbums", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: similarAlbums" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves similarAlbums relationship." }, { "info": { "name": "Get suggestedCoverArts relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/albums/:id/relationships/suggestedCoverArts", "params": [ { "name": "id", "value": "251380836", "type": "path", "description": "Album id" }, { "name": "include", "value": "suggestedCoverArts", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: suggestedCoverArts" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves suggestedCoverArts relationship." }, { "info": { "name": "Get usageRules relationship (\"to-one\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/albums/:id/relationships/usageRules", "params": [ { "name": "id", "value": "251380836", "type": "path", "description": "Album id" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "usageRules", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: usageRules" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves usageRules relationship." } ] }, { "info": { "name": "artistBiographies", "type": "folder" }, "items": [ { "info": { "name": "Get multiple artistBiographies.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/artistBiographies", "params": [ { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "owners", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: owners" }, { "name": "filter[id]", "value": "", "type": "query", "description": "Artist id (e.g. `1566`)" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves multiple artistBiographies by available filters, or without if applicable." }, { "info": { "name": "Get single artistBiographie.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/artistBiographies/:id", "params": [ { "name": "id", "value": "123456", "type": "path", "description": "Artist biography id" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "owners", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: owners" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves single artistBiographie by id." }, { "info": { "name": "Update single artistBiographie.", "type": "http" }, "http": { "method": "PATCH", "url": "https://openapi.tidal.com/v2/artistBiographies/:id", "params": [ { "name": "id", "value": "123456", "type": "path", "description": "Artist biography id" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Updates existing artistBiographie." }, { "info": { "name": "Get owners relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/artistBiographies/:id/relationships/owners", "params": [ { "name": "id", "value": "123456", "type": "path", "description": "Artist biography id" }, { "name": "include", "value": "owners", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: owners" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves owners relationship." } ] }, { "info": { "name": "artistRoles", "type": "folder" }, "items": [ { "info": { "name": "Get multiple artistRoles.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/artistRoles", "params": [ { "name": "filter[id]", "value": "", "type": "query", "description": "List of artist role IDs (e.g. `1`)" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves multiple artistRoles by available filters, or without if applicable." }, { "info": { "name": "Get single artistRole.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/artistRoles/:id", "params": [ { "name": "id", "value": "1", "type": "path", "description": "Artist role id" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves single artistRole by id." } ] }, { "info": { "name": "artists", "type": "folder" }, "items": [ { "info": { "name": "Get multiple artists.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/artists", "params": [ { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "albums", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: albums, biography, followers, following, owners, profileArt, radio, roles, similarArtists, trackProviders, tracks, videos" }, { "name": "filter[handle]", "value": "", "type": "query", "description": "Artist handle (e.g. `jayz`)" }, { "name": "filter[id]", "value": "", "type": "query", "description": "Artist id (e.g. `1566`)" }, { "name": "filter[owners.id]", "value": "", "type": "query", "description": "User id. Use `me` for the authenticated user" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves multiple artists by available filters, or without if applicable." }, { "info": { "name": "Create single artist.", "type": "http" }, "http": { "method": "POST", "url": "https://openapi.tidal.com/v2/artists", "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Creates a new artist." }, { "info": { "name": "Get single artist.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/artists/:id", "params": [ { "name": "id", "value": "1566", "type": "path", "description": "Artist id" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "albums", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: albums, biography, followers, following, owners, profileArt, radio, roles, similarArtists, trackProviders, tracks, videos" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves single artist by id." }, { "info": { "name": "Update single artist.", "type": "http" }, "http": { "method": "PATCH", "url": "https://openapi.tidal.com/v2/artists/:id", "params": [ { "name": "id", "value": "1566", "type": "path", "description": "Artist id" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Updates existing artist." }, { "info": { "name": "Get albums relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/artists/:id/relationships/albums", "params": [ { "name": "id", "value": "1566", "type": "path", "description": "Artist id" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "albums", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: albums" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves albums relationship." }, { "info": { "name": "Get biography relationship (\"to-one\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/artists/:id/relationships/biography", "params": [ { "name": "id", "value": "1566", "type": "path", "description": "Artist id" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "biography", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: biography" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves biography relationship." }, { "info": { "name": "Get followers relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/artists/:id/relationships/followers", "params": [ { "name": "id", "value": "1566", "type": "path", "description": "Artist id" }, { "name": "viewerContext", "value": "", "type": "query" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "include", "value": "followers", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: followers" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves followers relationship." }, { "info": { "name": "Get following relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/artists/:id/relationships/following", "params": [ { "name": "id", "value": "1566", "type": "path", "description": "Artist id" }, { "name": "viewerContext", "value": "", "type": "query" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "include", "value": "following", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: following" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves following relationship." }, { "info": { "name": "Add to following relationship (\"to-many\").", "type": "http" }, "http": { "method": "POST", "url": "https://openapi.tidal.com/v2/artists/:id/relationships/following", "params": [ { "name": "id", "value": "1566", "type": "path", "description": "Artist id" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Adds item(s) to following relationship." }, { "info": { "name": "Delete from following relationship (\"to-many\").", "type": "http" }, "http": { "method": "DELETE", "url": "https://openapi.tidal.com/v2/artists/:id/relationships/following", "params": [ { "name": "id", "value": "1566", "type": "path", "description": "Artist id" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Deletes item(s) from following relationship." }, { "info": { "name": "Get owners relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/artists/:id/relationships/owners", "params": [ { "name": "id", "value": "1566", "type": "path", "description": "Artist id" }, { "name": "include", "value": "owners", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: owners" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves owners relationship." }, { "info": { "name": "Get profileArt relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/artists/:id/relationships/profileArt", "params": [ { "name": "id", "value": "1566", "type": "path", "description": "Artist id" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "profileArt", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: profileArt" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves profileArt relationship." }, { "info": { "name": "Update profileArt relationship (\"to-many\").", "type": "http" }, "http": { "method": "PATCH", "url": "https://openapi.tidal.com/v2/artists/:id/relationships/profileArt", "params": [ { "name": "id", "value": "1566", "type": "path", "description": "Artist id" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Updates profileArt relationship." }, { "info": { "name": "Get radio relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/artists/:id/relationships/radio", "params": [ { "name": "id", "value": "1566", "type": "path", "description": "Artist id" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "radio", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: radio" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves radio relationship." }, { "info": { "name": "Get roles relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/artists/:id/relationships/roles", "params": [ { "name": "id", "value": "1566", "type": "path", "description": "Artist id" }, { "name": "include", "value": "roles", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: roles" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves roles relationship." }, { "info": { "name": "Get similarArtists relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/artists/:id/relationships/similarArtists", "params": [ { "name": "id", "value": "1566", "type": "path", "description": "Artist id" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "similarArtists", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: similarArtists" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves similarArtists relationship." }, { "info": { "name": "Get trackProviders relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/artists/:id/relationships/trackProviders", "params": [ { "name": "id", "value": "1566", "type": "path", "description": "Artist id" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "include", "value": "trackProviders", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: trackProviders" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves trackProviders relationship." }, { "info": { "name": "Get tracks relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/artists/:id/relationships/tracks", "params": [ { "name": "id", "value": "1566", "type": "path", "description": "Artist id" }, { "name": "collapseBy", "value": "FINGERPRINT", "type": "query", "description": "Collapse by options for getting artist tracks. Available options: FINGERPRINT, ID. FINGERPRINT option might collapse similar tracks based entry fingerprints while collapsing by ID always returns all available items." }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "tracks", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: tracks" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves tracks relationship." }, { "info": { "name": "Get videos relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/artists/:id/relationships/videos", "params": [ { "name": "id", "value": "1566", "type": "path", "description": "Artist id" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "videos", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: videos" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves videos relationship." } ] }, { "info": { "name": "artworks", "type": "folder" }, "items": [ { "info": { "name": "Get multiple artworks.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/artworks", "params": [ { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "owners", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: owners" }, { "name": "filter[id]", "value": "", "type": "query", "description": "Artwork id (e.g. `a468bee88def`)" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves multiple artworks by available filters, or without if applicable." }, { "info": { "name": "Create single artwork.", "type": "http" }, "http": { "method": "POST", "url": "https://openapi.tidal.com/v2/artworks", "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Creates a new artwork." }, { "info": { "name": "Get single artwork.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/artworks/:id", "params": [ { "name": "id", "value": "a468bee88def", "type": "path", "description": "Artwork id" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "owners", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: owners" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves single artwork by id." }, { "info": { "name": "Get owners relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/artworks/:id/relationships/owners", "params": [ { "name": "id", "value": "a468bee88def", "type": "path", "description": "Artwork id" }, { "name": "include", "value": "owners", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: owners" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves owners relationship." } ] }, { "info": { "name": "credits", "type": "folder" }, "items": [ { "info": { "name": "Get multiple credits.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/credits", "params": [ { "name": "include", "value": "artist", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: artist, category" }, { "name": "filter[id]", "value": "", "type": "query", "description": "List of credit IDs (e.g. `3fG7kLmN2pQrStUv`)" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves multiple credits by available filters, or without if applicable." }, { "info": { "name": "Get single credit.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/credits/:id", "params": [ { "name": "id", "value": "3fG7kLmN2pQrStUv", "type": "path", "description": "Credit id" }, { "name": "include", "value": "artist", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: artist, category" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves single credit by id." }, { "info": { "name": "Get artist relationship (\"to-one\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/credits/:id/relationships/artist", "params": [ { "name": "id", "value": "3fG7kLmN2pQrStUv", "type": "path", "description": "Credit id" }, { "name": "include", "value": "artist", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: artist" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves artist relationship." }, { "info": { "name": "Get category relationship (\"to-one\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/credits/:id/relationships/category", "params": [ { "name": "id", "value": "3fG7kLmN2pQrStUv", "type": "path", "description": "Credit id" }, { "name": "include", "value": "category", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: category" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves category relationship." } ] }, { "info": { "name": "genres", "type": "folder" }, "items": [ { "info": { "name": "Get multiple genres.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/genres", "params": [ { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "locale", "value": "en-US", "type": "query", "description": "BCP 47 locale (e.g., en-US, nb-NO, pt-BR). Defaults to en-US if not provided or unsupported." }, { "name": "filter[id]", "value": "", "type": "query", "description": "Allows filtering by genre id(s). USER_SELECTABLE is special value used to return specific genres which users can select from (e.g. `'1,2,3' or 'USER_SELECTABLE'`)" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves multiple genres by available filters, or without if applicable." }, { "info": { "name": "Get single genre.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/genres/:id", "params": [ { "name": "id", "value": "123", "type": "path", "description": "Genre id" }, { "name": "locale", "value": "en-US", "type": "query", "description": "BCP 47 locale (e.g., en-US, nb-NO, pt-BR). Defaults to en-US if not provided or unsupported." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves single genre by id." } ] }, { "info": { "name": "lyrics", "type": "folder" }, "items": [ { "info": { "name": "Get multiple lyrics.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/lyrics", "params": [ { "name": "include", "value": "owners", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: owners, track" }, { "name": "filter[id]", "value": "", "type": "query", "description": "Lyrics Id (e.g. `nejMcAhh5N8S3EQ4LaqysVdI0cZZ`)" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves multiple lyrics by available filters, or without if applicable." }, { "info": { "name": "Create single lyric.", "type": "http" }, "http": { "method": "POST", "url": "https://openapi.tidal.com/v2/lyrics", "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Creates a new lyric." }, { "info": { "name": "Get single lyric.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/lyrics/:id", "params": [ { "name": "id", "value": "nejMcAhh5N8S3EQ4LaqysVdI0cZZ", "type": "path", "description": "Lyrics Id" }, { "name": "include", "value": "owners", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: owners, track" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves single lyric by id." }, { "info": { "name": "Update single lyric.", "type": "http" }, "http": { "method": "PATCH", "url": "https://openapi.tidal.com/v2/lyrics/:id", "params": [ { "name": "id", "value": "nejMcAhh5N8S3EQ4LaqysVdI0cZZ", "type": "path", "description": "Lyrics Id" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Updates existing lyric." }, { "info": { "name": "Delete single lyric.", "type": "http" }, "http": { "method": "DELETE", "url": "https://openapi.tidal.com/v2/lyrics/:id", "params": [ { "name": "id", "value": "nejMcAhh5N8S3EQ4LaqysVdI0cZZ", "type": "path", "description": "Lyrics Id" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Deletes existing lyric." }, { "info": { "name": "Get owners relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/lyrics/:id/relationships/owners", "params": [ { "name": "id", "value": "nejMcAhh5N8S3EQ4LaqysVdI0cZZ", "type": "path", "description": "Lyrics Id" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "owners", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: owners" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves owners relationship." }, { "info": { "name": "Get track relationship (\"to-one\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/lyrics/:id/relationships/track", "params": [ { "name": "id", "value": "nejMcAhh5N8S3EQ4LaqysVdI0cZZ", "type": "path", "description": "Lyrics Id" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "track", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: track" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves track relationship." } ] }, { "info": { "name": "providerOwners", "type": "folder" }, "items": [ { "info": { "name": "Get multiple providerOwners.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/providerOwners", "params": [ { "name": "include", "value": "owners", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: owners, provider" }, { "name": "filter[owners.id]", "value": "", "type": "query", "description": "User id. Use `me` for the authenticated user" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves multiple providerOwners by available filters, or without if applicable." }, { "info": { "name": "Get owners relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/providerOwners/:id/relationships/owners", "params": [ { "name": "id", "value": "", "type": "path", "description": "Provider owner id" }, { "name": "include", "value": "owners", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: owners" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves owners relationship." }, { "info": { "name": "Get provider relationship (\"to-one\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/providerOwners/:id/relationships/provider", "params": [ { "name": "id", "value": "", "type": "path", "description": "Provider owner id" }, { "name": "include", "value": "provider", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: provider" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves provider relationship." } ] }, { "info": { "name": "providerProductInfos", "type": "folder" }, "items": [ { "info": { "name": "Get multiple providerProductInfos.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/providerProductInfos", "params": [ { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "provider", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: provider, subject" }, { "name": "filter[barcodeId]", "value": "", "type": "query", "description": "List of barcode IDs (EAN-13 or UPC-A) (e.g. `00602527336510`)" }, { "name": "filter[provider.id]", "value": "", "type": "query", "description": "Content provider ID (e.g. `50`)" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves multiple providerProductInfos by available filters, or without if applicable." }, { "info": { "name": "Get provider relationship (\"to-one\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/providerProductInfos/:id/relationships/provider", "params": [ { "name": "id", "value": "", "type": "path", "description": "Provider product info id" }, { "name": "include", "value": "provider", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: provider" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves provider relationship." }, { "info": { "name": "Get subject relationship (\"to-one\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/providerProductInfos/:id/relationships/subject", "params": [ { "name": "id", "value": "", "type": "path", "description": "Provider product info id" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "subject", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: subject" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves subject relationship." } ] }, { "info": { "name": "providers", "type": "folder" }, "items": [ { "info": { "name": "Get multiple providers.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/providers", "params": [ { "name": "filter[id]", "value": "", "type": "query", "description": "List of provider IDs (e.g. `12345`)" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves multiple providers by available filters, or without if applicable." }, { "info": { "name": "Get single provider.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/providers/:id", "params": [ { "name": "id", "value": "12345", "type": "path", "description": "Provider ID" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves single provider by id." } ] }, { "info": { "name": "trackStatistics", "type": "folder" }, "items": [ { "info": { "name": "Get multiple trackStatistics.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/trackStatistics", "params": [ { "name": "include", "value": "owners", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: owners" }, { "name": "filter[id]", "value": "", "type": "query", "description": "List of track IDs (e.g. `75413016`)" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves multiple trackStatistics by available filters, or without if applicable." }, { "info": { "name": "Get single trackStatistic.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/trackStatistics/:id", "params": [ { "name": "id", "value": "123456", "type": "path", "description": "Track statistic id" }, { "name": "include", "value": "owners", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: owners" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves single trackStatistic by id." }, { "info": { "name": "Get owners relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/trackStatistics/:id/relationships/owners", "params": [ { "name": "id", "value": "123456", "type": "path", "description": "Track statistic id" }, { "name": "include", "value": "owners", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: owners" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves owners relationship." } ] }, { "info": { "name": "tracks", "type": "folder" }, "items": [ { "info": { "name": "Get multiple tracks.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/tracks", "params": [ { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "sort", "value": "", "type": "query", "description": "Values prefixed with \"-\" are sorted descending; values without it are sorted ascending." }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "albums", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: albums, artists, credits, download, genres, lyrics, metadataStatus, owners, priceConfig, providers, radio, replacement, shares, similarTracks, sourceFile, suggestedTracks, trackStatistics, usageRules" }, { "name": "filter[id]", "value": "", "type": "query", "description": "List of track IDs (e.g. `75413016`)" }, { "name": "filter[isrc]", "value": "", "type": "query", "description": "List of ISRCs. When a single ISRC is provided, pagination is supported and multiple tracks may be returned. When multiple ISRCs are provided, one track per ISRC is returned without pagination. (e.g. `QMJMT1701237`)" }, { "name": "filter[owners.id]", "value": "", "type": "query", "description": "User id. Use `me` for the authenticated user" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves multiple tracks by available filters, or without if applicable." }, { "info": { "name": "Create single track.", "type": "http" }, "http": { "method": "POST", "url": "https://openapi.tidal.com/v2/tracks", "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Creates a new track." }, { "info": { "name": "Get single track.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/tracks/:id", "params": [ { "name": "id", "value": "75413016", "type": "path", "description": "Track id" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "albums", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: albums, artists, credits, download, genres, lyrics, metadataStatus, owners, priceConfig, providers, radio, replacement, shares, similarTracks, sourceFile, suggestedTracks, trackStatistics, usageRules" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves single track by id." }, { "info": { "name": "Update single track.", "type": "http" }, "http": { "method": "PATCH", "url": "https://openapi.tidal.com/v2/tracks/:id", "params": [ { "name": "id", "value": "75413016", "type": "path", "description": "Track id" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Updates existing track." }, { "info": { "name": "Delete single track.", "type": "http" }, "http": { "method": "DELETE", "url": "https://openapi.tidal.com/v2/tracks/:id", "params": [ { "name": "id", "value": "75413016", "type": "path", "description": "Track id" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Deletes existing track." }, { "info": { "name": "Get albums relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/tracks/:id/relationships/albums", "params": [ { "name": "id", "value": "75413016", "type": "path", "description": "Track id" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "albums", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: albums" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves albums relationship." }, { "info": { "name": "Update albums relationship (\"to-many\").", "type": "http" }, "http": { "method": "PATCH", "url": "https://openapi.tidal.com/v2/tracks/:id/relationships/albums", "params": [ { "name": "id", "value": "75413016", "type": "path", "description": "Track id" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Updates albums relationship." }, { "info": { "name": "Get artists relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/tracks/:id/relationships/artists", "params": [ { "name": "id", "value": "75413016", "type": "path", "description": "Track id" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "artists", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: artists" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves artists relationship." }, { "info": { "name": "Get credits relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/tracks/:id/relationships/credits", "params": [ { "name": "id", "value": "75413016", "type": "path", "description": "Track id" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "include", "value": "credits", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: credits" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves credits relationship." }, { "info": { "name": "Get download relationship (\"to-one\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/tracks/:id/relationships/download", "params": [ { "name": "id", "value": "75413016", "type": "path", "description": "Track id" }, { "name": "include", "value": "download", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: download" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves download relationship." }, { "info": { "name": "Get genres relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/tracks/:id/relationships/genres", "params": [ { "name": "id", "value": "75413016", "type": "path", "description": "Track id" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "genres", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: genres" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves genres relationship." }, { "info": { "name": "Get lyrics relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/tracks/:id/relationships/lyrics", "params": [ { "name": "id", "value": "75413016", "type": "path", "description": "Track id" }, { "name": "include", "value": "lyrics", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: lyrics" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves lyrics relationship." }, { "info": { "name": "Get metadataStatus relationship (\"to-one\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/tracks/:id/relationships/metadataStatus", "params": [ { "name": "id", "value": "75413016", "type": "path", "description": "Track id" }, { "name": "include", "value": "metadataStatus", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: metadataStatus" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves metadataStatus relationship." }, { "info": { "name": "Get owners relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/tracks/:id/relationships/owners", "params": [ { "name": "id", "value": "75413016", "type": "path", "description": "Track id" }, { "name": "include", "value": "owners", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: owners" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves owners relationship." }, { "info": { "name": "Get priceConfig relationship (\"to-one\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/tracks/:id/relationships/priceConfig", "params": [ { "name": "id", "value": "75413016", "type": "path", "description": "Track id" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "priceConfig", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: priceConfig" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves priceConfig relationship." }, { "info": { "name": "Get providers relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/tracks/:id/relationships/providers", "params": [ { "name": "id", "value": "75413016", "type": "path", "description": "Track id" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "providers", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: providers" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves providers relationship." }, { "info": { "name": "Get radio relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/tracks/:id/relationships/radio", "params": [ { "name": "id", "value": "75413016", "type": "path", "description": "Track id" }, { "name": "include", "value": "radio", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: radio" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves radio relationship." }, { "info": { "name": "Get replacement relationship (\"to-one\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/tracks/:id/relationships/replacement", "params": [ { "name": "id", "value": "75413016", "type": "path", "description": "Track id" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "replacement", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: replacement" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves replacement relationship." }, { "info": { "name": "Get shares relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/tracks/:id/relationships/shares", "params": [ { "name": "id", "value": "75413016", "type": "path", "description": "Track id" }, { "name": "include", "value": "shares", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: shares" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves shares relationship." }, { "info": { "name": "Get similarTracks relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/tracks/:id/relationships/similarTracks", "params": [ { "name": "id", "value": "75413016", "type": "path", "description": "Track id" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "similarTracks", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: similarTracks" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves similarTracks relationship." }, { "info": { "name": "Get sourceFile relationship (\"to-one\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/tracks/:id/relationships/sourceFile", "params": [ { "name": "id", "value": "75413016", "type": "path", "description": "Track id" }, { "name": "include", "value": "sourceFile", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: sourceFile" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves sourceFile relationship." }, { "info": { "name": "Get suggestedTracks relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/tracks/:id/relationships/suggestedTracks", "params": [ { "name": "id", "value": "75413016", "type": "path", "description": "Track id" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "suggestedTracks", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: suggestedTracks" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves suggestedTracks relationship." }, { "info": { "name": "Get trackStatistics relationship (\"to-one\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/tracks/:id/relationships/trackStatistics", "params": [ { "name": "id", "value": "75413016", "type": "path", "description": "Track id" }, { "name": "include", "value": "trackStatistics", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: trackStatistics" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves trackStatistics relationship." }, { "info": { "name": "Get usageRules relationship (\"to-one\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/tracks/:id/relationships/usageRules", "params": [ { "name": "id", "value": "75413016", "type": "path", "description": "Track id" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "usageRules", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: usageRules" }, { "name": "shareCode", "value": "", "type": "query", "description": "Share code that grants access to UNLISTED resources. When provided, allows non-owners to access resources that would otherwise be restricted." } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves usageRules relationship." } ] }, { "info": { "name": "tracksMetadataStatus", "type": "folder" }, "items": [ { "info": { "name": "Get multiple tracksMetadataStatus.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/tracksMetadataStatus", "params": [ { "name": "filter[id]", "value": "", "type": "query", "description": "List of track IDs (e.g. `75413016`)" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves multiple tracksMetadataStatus by available filters, or without if applicable." }, { "info": { "name": "Get single tracksMetadataStatu.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/tracksMetadataStatus/:id", "params": [ { "name": "id", "value": "123456", "type": "path", "description": "Tracks metadata status id" } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://login.tidal.com/authorize", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves single tracksMetadataStatu by id." } ] }, { "info": { "name": "videos", "type": "folder" }, "items": [ { "info": { "name": "Get multiple videos.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/videos", "params": [ { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "albums", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: albums, artists, credits, providers, replacement, similarVideos, suggestedVideos, thumbnailArt, usageRules" }, { "name": "filter[id]", "value": "", "type": "query", "description": "List of video IDs (e.g. `75623239`)" }, { "name": "filter[isrc]", "value": "", "type": "query", "description": "List of ISRCs (e.g. `QMJMT1701237`)" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves multiple videos by available filters, or without if applicable." }, { "info": { "name": "Get single video.", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/videos/:id", "params": [ { "name": "id", "value": "75623239", "type": "path", "description": "Video id" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "albums", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: albums, artists, credits, providers, replacement, similarVideos, suggestedVideos, thumbnailArt, usageRules" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves single video by id." }, { "info": { "name": "Get albums relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/videos/:id/relationships/albums", "params": [ { "name": "id", "value": "75623239", "type": "path", "description": "Video id" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "albums", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: albums" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves albums relationship." }, { "info": { "name": "Get artists relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/videos/:id/relationships/artists", "params": [ { "name": "id", "value": "75623239", "type": "path", "description": "Video id" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "artists", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: artists" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves artists relationship." }, { "info": { "name": "Get credits relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/videos/:id/relationships/credits", "params": [ { "name": "id", "value": "75623239", "type": "path", "description": "Video id" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "include", "value": "credits", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: credits" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves credits relationship." }, { "info": { "name": "Get providers relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/videos/:id/relationships/providers", "params": [ { "name": "id", "value": "75623239", "type": "path", "description": "Video id" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "providers", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: providers" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves providers relationship." }, { "info": { "name": "Get replacement relationship (\"to-one\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/videos/:id/relationships/replacement", "params": [ { "name": "id", "value": "75623239", "type": "path", "description": "Video id" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "replacement", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: replacement" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves replacement relationship." }, { "info": { "name": "Get similarVideos relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/videos/:id/relationships/similarVideos", "params": [ { "name": "id", "value": "75623239", "type": "path", "description": "Video id" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "similarVideos", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: similarVideos" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves similarVideos relationship." }, { "info": { "name": "Get suggestedVideos relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/videos/:id/relationships/suggestedVideos", "params": [ { "name": "id", "value": "75623239", "type": "path", "description": "Video id" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "suggestedVideos", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: suggestedVideos" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves suggestedVideos relationship." }, { "info": { "name": "Get thumbnailArt relationship (\"to-many\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/videos/:id/relationships/thumbnailArt", "params": [ { "name": "id", "value": "75623239", "type": "path", "description": "Video id" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "thumbnailArt", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: thumbnailArt" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves thumbnailArt relationship." }, { "info": { "name": "Get usageRules relationship (\"to-one\").", "type": "http" }, "http": { "method": "GET", "url": "https://openapi.tidal.com/v2/videos/:id/relationships/usageRules", "params": [ { "name": "id", "value": "75623239", "type": "path", "description": "Video id" }, { "name": "countryCode", "value": "US", "type": "query", "description": "ISO 3166-1 alpha-2 country code" }, { "name": "include", "value": "usageRules", "type": "query", "description": "Allows the client to customize which related resources should be returned. Available options: usageRules" } ], "auth": { "type": "oauth2", "flow": "client_credentials", "accessTokenUrl": "https://auth.tidal.com/v1/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Retrieves usageRules relationship." } ] } ], "bundled": true }