Gallery Platform API
ReferenceGalleryArtists

List artists

Lists the artists in the gallery's organization, newest first, with cursor pagination. Pass `q` to match by name — use this to resolve an artist name to an id for the artwork `artist_id` filter. The roster is org-scoped; RLS returns it only to members of the gallery's organization.

GET
/gallery/artists

Lists the artists in the gallery's organization, newest first, with cursor pagination. Pass q to match by name — use this to resolve an artist name to an id for the artwork artist_id filter. The roster is org-scoped; RLS returns it only to members of the gallery's organization.

Authorization

bearerAuth artworks:read
AuthorizationBearer <token>

A gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).

In: header

Scope: artworks:read

Query Parameters

limit*integer
Range1 <= value <= 100
Default20
cursor?string
q?string
Lengthlength <= 200

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/gallery/artists?limit=20"
{  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "name": "string",      "sort_name": "string",      "nationality": "string",      "birth_year": -9007199254740991,      "death_year": -9007199254740991,      "biography": "string",      "website_url": "string",      "created_at": "string"    }  ],  "next_cursor": "string"}