Registry API v1

Galleries

Read-only gallery profiles and the works a gallery publishes to the registry.

Endpoints

Method	Path	Scope
GET	`/api/v1/galleries/{id}`	`galleries:read`
GET	`/api/v1/galleries/{id}/artworks`	`artworks:read`

{id} accepts the gallery slug or uuid. Unknown or non-public profiles return 404 gallery_not_found.

Gallery object

Field	Type	Notes
`object`	string	Always `"gallery"`.
`id`	uuid
`slug`	string
`name`	string
`type`	string	Collection type as registered.
`description`	string \| null	Public profile description.
`city`	string \| null
`country`	string \| null
`website`	string \| null
`is_verified`	boolean	Whether Collect24 verified the profile.
`artwork_count`	number	Public works currently in the projection.
`links`	object	self, artworks and public_page.

Owner and claimant identifiers are never returned, whether the profile is claimed or not.

Read a gallery

GET /api/v1/galleries/{id}

curl https://collect24.art/api/v1/galleries/gallery-example \
  -H "Authorization: Bearer c24_live_..."

200 response

{
  "object": "gallery",
  "id": "0a5e2d61-7c4f-4d0e-9b32-8e1c73ab5410",
  "slug": "gallery-example",
  "name": "Gallery Example",
  "type": "gallery",
  "description": "Contemporary gallery in Antwerp representing…",
  "city": "Antwerp",
  "country": "BE",
  "website": "https://gallery.example",
  "is_verified": true,
  "artwork_count": 148,
  "links": {
    "self": "/api/v1/galleries/gallery-example",
    "artworks": "/api/v1/galleries/gallery-example/artworks",
    "public_page": "https://collect24.art/collections/gallery-example"
  }
}

A gallery's artworks

Same list envelope and artwork objects as GET /api/v1/artworks, restricted to that gallery. Supports limit (max 100), offset and updated_since for incremental sync.

GET /api/v1/galleries/{id}/artworks

curl "https://collect24.art/api/v1/galleries/gallery-example/artworks?availability=for_sale&limit=100" \
  -H "Authorization: Bearer c24_live_..."

Images and rights

Image URLs in the response point at the source the gallery published or at a Collect24 thumbnail. Access to the API does not grant rights to redistribute images or other third-party content — you remain responsible for the rights and licensing attached to each work.