close
The Wayback Machine - https://web.archive.org/web/20140813165619/https://developer.beatsmusic.com/docs/read/follows/Follow_Status

Follow Status

Checks whether a user follows another user. Returns ResourceNotFound (404) error if not.


PLEASE NOTE:

The relation attribute refers to the relationship between the requester of the resource and the target_id. Not the id and target_id, which is given by either a 200 for present or 404 for not present.

Example:
user 12345 issues the following request:
GET /api/users/67333/follows/99999 -> Does 67333 follow 99999?


If this is true then a 200 will be returned along with the relationship entry. The relation field will indicate whether 12345 is also following 99999.


Endpoint URL

/api/:type/:id/follows/:target_id


HTTP Method

GET


Authentication

OAuth 2.0: Access token required. See Authentication for examples and details.


Parameters

Name Required Description Example
type required type of the id

Example:
users, curators, genres

 

users
id required ID of the user, curator, genre

 

12345

Response Elements

ResponseDescription
code

Beats API response code. If successful, code is 'OK'. Otherwise it will be an error code.


Example Response

{
    "code": "OK",
    "data": {
        "type": "relationship",
        "relation": "follows",
        "object": {
            "type": "user",
            "id": "N3QnTIN2TDM",
            "full_name": "Ted Heffner",
            "username": "teddy",
            "country": "US",
            "total_followed_by": "string",
            "total_follows": "string"
        }
    }
}

Docs Navigation