Gallery Platform API
Reference

List holds

Lists the gallery's holds with cursor pagination, newest first. Filter by `artwork_id` or `party_id`.

GET
/gallery/holds

Lists the gallery's holds with cursor pagination, newest first. Filter by artwork_id or party_id.

Authorization

bearerAuth artworks:update, contacts:read
AuthorizationBearer <token>

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

In: header

Scope: artworks:update, contacts:read

Query Parameters

limit?integer

Page size. Defaults to 20; the maximum is 100.

Range1 <= value <= 100
Default20
cursor?string

Opaque cursor from the previous page's next_cursor. Omit for the first page.

artwork_id?string

Filter to the given artwork id.

party_id?string

Filter to the given party id.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

{  "data": [    {      "id": "string",      "artwork_id": "string",      "party_id": "string",      "ends_on": "string",      "released_at": "string",      "released_reason": "string",      "note": "string",      "created_at": "string",      "updated_at": "string"    }  ],  "next_cursor": "string"}