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

API access is invite-only. Contact contact@beatpass.ca to request access. Once approved, generate tokens from Account Settings → Developers. Include as: Authorization: Bearer {token}. Tokens expire after 90 days.

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 March 20, 2026