The API reference

GET /api/v1/artists

The artists the signed-in person is a member of, with their permission on each.

GET /api/v1/artists
Authorization: Bearer {token}
Accept: application/json

{
  "data": [
    {
      "handle": "nightshift",
      "name": "Night Shift",
      "permission": "owner",
      "verified_at": "2026-09-03T14:02:11+00:00",
      "url": "https://…/nightshift",
      …
    }
  ]
}

GET /api/v1/artists/{identifier}

One artist, by handle or by artist number: id, handle, name, bio in Markdown and bio_html, intro, facts, avatar, hero, logo, favicon, images (the press photos), logos, riders, channels, shop, releases, quotes, videos, contacts, verified_at, the date TAP verified the artist or null, published_at and updated_at. It carries the artist's own addresses as well: url is the website, epk_url the EPK, and visibility answers who can see each of the four pages (website, links, music, epk), with null where the artist does not use that page. Each fact carries type, label and a list of values, in the order the artist set. Each release carries title, slug, kind, artists, release_date, release_date_precision, upc, links, artwork and url; upc is null until a platform agrees to the barcode, and the list is filled while the artist's music page is public and empty otherwise. The response itself carries no artist number: the number is a team-only reference, so work from the handle unless you already store one. Each contact carries name, company, role, email, phone, website and avatar, the same people the artist's own pages show. Each press quote carries quote, publication, author, published_on and url, in the order the artist set; only the quote and the publication are always there. Each video carries title, url and is_live, in the order the artist set; is_live marks a live set. shop carries label, tagline and url, or is null when the artist has no shop.

GET /api/v1/artists/nightshift
Authorization: Bearer {token}
Accept: application/json
If-None-Match: "8f3a1c"

200 OK
ETag: "b21e07"

{
  "handle": "nightshift",
  "name": "Night Shift",
  "url": "https://…/nightshift",
  "epk_url": "https://…/nightshift/epk",
  "visibility": {
    "website": "public",
    "links": "public",
    "music": "public",
    "epk": "unlisted"
  },
  "verified_at": "2026-09-03T14:02:11+00:00",
  "bio": "Night Shift is a Rotterdam duo playing slow, heavy techno…",
  "intro": "Rotterdam duo, slow and heavy, two hours at a time.",
  "facts": [
    {
      "type": "genre",
      "label": "Genre",
      "values": [{ "value": "hard techno", "label": "Hard techno" }]
    }
  ],
  "channels": [ … ],
  "releases": [
    {
      "title": "Osiris",
      "slug": "osiris",
      "kind": "single",
      "artists": ["Night Shift", "Break of Dawn"],
      "release_date": "2026-08-14",
      "release_date_precision": "day",
      "upc": "8718522301292",
      "links": { "spotify": "https://…" },
      "artwork": { "url": "https://…/osiris.jpg", "…": "…" },
      "url": "https://…/nightshift/music/osiris"
    }
  ],
  "quotes": [
    {
      "quote": "Two hours that never once looked back.",
      "publication": "Resident Advisor",
      "author": "Lena Bakker",
      "published_on": "2026-03-12",
      "url": "https://ra.co/reviews/night-shift"
    }
  ],
  "videos": [
    {
      "title": "Dekmantel 2026",
      "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
      "is_live": true
    }
  ],
  "contacts": [
    {
      "name": "Superform",
      "company": "Superform Agency",
      "role": "Booking",
      "roles": [{ "value": "agent", "label": "Agent" }],
      "territories": [{ "value": "europe", "label": "Europe" }],
      "email": "bookings@superform.example",
      "phone": "+31 10 123 4567",
      "website": "https://superform.example",
      "avatar": "https://…/superform.jpg"
    }
  ]
}

Contacts retain the existing role field. The additive roles and territories fields contain ordered {value, label} objects. An empty roles list means there are no selected roles; the original role text is retained separately for compatibility. Territories apply to contacts with the Agent role. Team-member contacts carry their single team role in roles and an empty territories list.

Each rider retains name, url, mime_type and size, and adds a nullable kind. The values are technical, stage_plot, hospitality and input_list. A null kind means the artist left the file as Rider.

What a token can be

• A personal token, made under API tokens in your account. It carries your own authority: Personal API tokens.
• A token a person granted your app through Sign in with TAP, with the scope artists:read: Sign in with TAP: scopes and the consent screen.
• A client-credentials token of an approved app, for published artists, no person present: Quickstart.

Conditional requests

Every single-artist response carries an ETag. Send it back as If-None-Match and an unchanged artist answers 304, so polling stays cheap. Responses are private and good for 60 seconds.

Not found

For a server token, an artist that is not published, or suspended, answers 404, the same as an unknown handle. A person's token reads the artists they belong to whether those are published or not. Do not infer from a 404 that the artist exists.

Status codes

What it costs at volume is on the partners page.