Skip to main content
GET
/
artists
/
{id}
Get an Artist
curl --request GET \
  --url https://open.beatpass.ca/api/v1/artists/{id} \
  --header 'Authorization: Bearer <token>'
{
  "status": "success",
  "artist": {
    "id": 123,
    "name": "Led Zeppelin",
    "image_small": "https://example.com/image1.jpg",
    "verified": true,
    "albums": {
      "current_page": 1,
      "from": 1,
      "to": 100,
      "per_page": 25,
      "last_page": 156,
      "total": 264,
      "data": [
        {
          "id": 123,
          "name": "Coda",
          "image": "https://example.com/image1.jpg",
          "release_date": "1982-11-19",
          "description": "<string>",
          "tracks": [
            {
              "id": 123,
              "name": "Hey Hey What Can I Do",
              "release_date": "1982-11-19",
              "image": "https://example.com/image1.jpg",
              "duration": 5645848548,
              "description": "<string>",
              "artists": [
                {
                  "id": 123,
                  "name": "Led Zeppelin",
                  "image_small": "https://example.com/image1.jpg",
                  "verified": true
                }
              ]
            }
          ],
          "artists": [
            {
              "id": 123,
              "name": "Led Zeppelin",
              "image_small": "https://example.com/image1.jpg",
              "verified": true
            }
          ]
        }
      ]
    },
    "similar": [
      {
        "id": 123,
        "name": "Led Zeppelin",
        "image_small": "https://example.com/image1.jpg",
        "verified": true
      }
    ],
    "top_tracks": [
      {
        "id": 123,
        "name": "Hey Hey What Can I Do",
        "release_date": "1982-11-19",
        "image": "https://example.com/image1.jpg",
        "duration": 5645848548,
        "description": "<string>",
        "artists": [
          {
            "id": 123,
            "name": "Led Zeppelin",
            "image_small": "https://example.com/image1.jpg",
            "verified": true
          }
        ]
      }
    ],
    "genres": [
      {
        "id": 1,
        "name": "rock"
      }
    ],
    "profile": {
      "id": 1,
      "description": "<string>",
      "city": "<string>",
      "country": "<string>"
    },
    "profile_images": [
      {
        "id": 1,
        "url": "https://site.com/image.jpg"
      }
    ],
    "links": [
      {
        "id": 1,
        "url": "https://facebook.com",
        "title": "Facebook"
      }
    ]
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
integer
required

ID of the artist

Query Parameters

with
string

Comma separated list of additional data to fetch for this artist. Supported values: similar, genres, albums, topTracks.

Example:

"albums,genres"

Response

Response body contains an artist object in JSON format.

status
string
Example:

"success"

artist
object
Last modified on November 29, 2025