List art fairs (directory)
Lists the shared art-fair directory — canonical fair editions plus this gallery's own pending suggestions. Filter by a name query.
Lists the shared art-fair directory — canonical fair editions plus this gallery's own pending suggestions. Filter by a name query.
Authorization
bearerAuth shows:readA gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).
In: header
Scope: shows:read
Query Parameters
1 <= value <= 100201 <= length <= 200Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
{ "data": [ { "id": "string", "name": "string", "edition": "string", "city": "string", "country": "string", "start_date": "string", "end_date": "string", "website_url": "string", "status": "canonical", "created_at": "string", "updated_at": "string" } ], "next_cursor": "string"}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}Suggest an art fair POST
Suggests a fair edition for the shared directory. It lands as a pending suggestion (visible only to this gallery) for staff to promote to canonical.
List artist connections GET
Lists the gallery's artist studio connections, newest first, with cursor pagination. Filter with ?status=active.