Gallery Platform API
Reference

List consignment proposals

Lists consignment-handoff proposals where this gallery is either side of the connection — incoming and outgoing in one list; `direction` tells them apart. Filter with ?status= or ?direction=.

GET
/gallery/consignment-proposals

Lists consignment-handoff proposals where this gallery is either side of the connection — incoming and outgoing in one list; direction tells them apart. Filter with ?status= or ?direction=.

Authorization

bearerAuth artists:read
AuthorizationBearer <token>

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

In: header

Scope: artists:read

Query Parameters

limit?integer
Range1 <= value <= 100
Default20
cursor?string
status?string

Value in

  • "proposed"
  • "offered"
  • "accepted"
  • "declined"
  • "withdrawn"
direction?string

Value in

  • "studio_to_gallery"
  • "gallery_to_studio"

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",      "connection_id": "string",      "direction": "studio_to_gallery",      "status": "proposed",      "source_artwork_id": "string",      "result_artwork_id": "string",      "proposed_split_bps": 0,      "payload": {        "title": "string",        "year": -9007199254740991,        "medium": "string",        "dimensions_text": "string",        "price_cents": -9007199254740991,        "currency": "string"      },      "decided_at": "string",      "created_at": "string"    }  ],  "next_cursor": "string"}