Endpoint

GET https://api.spotify.com/v1/me/following/contains

Request Parameters

Header Fields

Header Field Value
Authorization Required. A valid access token from the Spotify Accounts service: see the Web API Authorization Guide for details. The access token must have been issued on behalf of the current user. Getting details of the artists or users the current user follows requires authorization of the user-follow-read scope. See Using Scopes.

Query Parameters

Query Parameter Value
type Required. The ID type: either artist or user.
ids Required. A comma-separated list of the artist or the user Spotify IDs to check. For example: ids=74ASZWbe4lXaubB36ztrGX,08td7MxkoHQkXnWAYD8d6Q. A maximum of 50 IDs can be sent in one request.

Response Format

On success, the HTTP status code in the response header is 200 OK and the response body contains a JSON array of true or false values, in the same order in which the ids were specified. On error, the header status code is an error code and the response body contains an error object.

Examples

Check if the current user follows another user

We want to check if the current user is following the fake user Example User (whose Spotify uri is spotify:user:exampleuser01):

curl -X GET "https://api.spotify.com/v1/me/following/contains?type=user&ids=exampleuser01" -H "Authorization: Bearer {your access token}"
[ true ]

Try it

Check if the current user follows several artists

We want to check if the current user is following Bob Dylan (whose Spotify uri is spotify:artist:74ASZWbe4lXaubB36ztrGX) and Tania Bowra (whose Spotify uri is spotify:artist:08td7MxkoHQkXnWAYD8d6Q):

curl -X GET "https://api.spotify.com/v1/me/following/contains?type=artist&ids=74ASZWbe4lXaubB36ztrGX,08td7MxkoHQkXnWAYD8d6Q" -H "Authorization: Bearer {your access token}"
[ true, false ]

Try it