---
title: "List artists"
method: GET
path: "/v1/artists"
tags: ["artists"]
---

# List artists

`GET /v1/artists`

## Request

- Base URL: `https://api.pokemontcgapi.com`
- URL: `https://api.pokemontcgapi.com/v1/artists`
- Auth: API key in header `X-Api-Key`

Every credited illustrator with a card count, searchable by name.

## Query parameters

- `q` string
- `orderBy` string
- `order_by` string
- `limit` integer
- `cursor` string

## Headers

- `If-None-Match` string

## Response `200`

Success

- object

## Other responses

- `304`: Not Modified — the ETag you sent still matches. No body, no quota.
- `400`: INVALID_PARAMETER, INVALID_CURSOR, LIMIT_EXCEEDED
- `401`: MISSING_API_KEY, INVALID_API_KEY
- `403`: PLAN_REQUIRED, TRIAL_EXPIRED
- `429`: QUOTA_EXCEEDED

---

[API](https://skmtc.dev/pokemontcgapi/apis/pokemon-tcg-api.md) · [All operations](https://skmtc.dev/pokemontcgapi/apis/pokemon-tcg-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pokemontcgapi/apis/pokemon-tcg-api/revisions/9e4ee9a375da?raw)