Check if Current User Follows Artists or Users

Check to see if the current user is following one or more artists or other Spotify users.

Endpoint

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

Request Parameters

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 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 in our Web API Console

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 ]