API & integrations
Build fine art insurance into your platform
Embedded insurance for galleries, auction houses, marketplaces and shippers: display an instant insurance estimate on every artwork or lot — much like an “estimate shipping” button — then let a Cimaise broker finalise the quote. All through a simple API.
Instant estimate
What your customers see
The widget returns a premium range in real time based on the artwork's value. Try it — this is exactly what your platform can embed.
Estimate the insurance · live demo
€
Annual cover
€200 – €300/ year
0.8–1.2% / year
Nail-to-nail transit (one-off)
€40 – €50
Indicative, non-binding estimate. The actual premium is set on a bespoke basis, at agreed value, after a Cimaise broker has assessed the risk.
Who it's for
Galleries & marketplaces
Offer cover at the point of sale or shipment, without leaving your checkout flow.
Fine art shipping platforms
Trigger a nail-to-nail quote for every scheduled shipment or loan.
Collection management software
Give your users an insurance estimate based on their inventory.
How it works
01
Get an API key
We issue a key dedicated to your platform.
02
Call /v1/quotes
Send the prospect's and the artwork's details as JSON.
03
A broker takes over
The request reaches us; a broker reviews it and gets back in touch within 48 hours.
Documentation
1. Instant estimate
Returns a premium range for a given value. Can be called from your frontend (CORS open) or server-to-server.
POST/api/v1/estimate
curl -X POST https://cimaise-assurance.com/api/v1/estimate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "value": 25000, "category": "Peinture" }'{
"ok": true,
"estimate": {
"currency": "EUR",
"value": 25000,
"annual": { "min": 200, "max": 300, "rate": "0.8–1.2 % / an" },
"transport": { "min": 40, "max": 50, "rate": "0,08–0,20 % de la valeur" },
"disclaimer": "Estimation indicative, non contractuelle…"
},
"quoteUrl": "https://cimaise-assurance.com/devis"
}2. Create a quote request
A single endpoint to get started. API key authentication, JSON request body, JSON response.
POST/api/v1/quotes
Authentication
Pass your key in the Authorization header (or X-API-Key).
Authorization: Bearer YOUR_API_KEYBody parameters
Field
Type
Description
nom
string
required
Contact's full name
email
string
required
Valid email address
telephone
string
required
Call-back number
profil
string
optional
Accepted values (in French): Collectionneur, Galerie / marchand, Artiste, Institution / musée, Maison de ventes
valeur
string
optional
Value band to be insured
natures
string[]
optional
Peinture (painting), Sculpture, Photographie (photography)…
besoins
string[]
optional
Transport à venir (upcoming transit), Prêt / exposition (loan / exhibition)…
codePostal
string
optional
Postcode of the main storage location
description
string
optional
Free-text context
partner
string
optional
Your platform identifier (included in the notification)
reference
string
optional
Your internal reference (returned in the response)
Example
curl -X POST https://cimaise-assurance.com/api/v1/quotes \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"partner": "my-gallery",
"reference": "CMD-1042",
"profil": "Collectionneur",
"valeur": "100 — 500 k€",
"natures": ["Peinture"],
"besoins": ["Transport à venir"],
"nom": "Camille Durand",
"email": "camille@example.com",
"telephone": "06 12 34 56 78"
}'Response — 201 Created
{
"ok": true,
"id": "q_ab12cd34ef",
"status": "received",
"reference": "CMD-1042"
}Error codes
401 — API key missing or invalid
422 — required fields missing (details are returned in
fields)503 — API not yet enabled
Frequently asked questions
Who can get API access?
Galleries, marketplaces, fine art shippers and software publishers who want to offer fine art insurance to their customers. Access is granted on request, with a dedicated key.
Does the API return an instant price?
Version 1 records the quote request and passes it to a broker, who reviews the risk and gets back in touch. A price is built to measure, on an agreed-value basis — no opaque algorithm.
How is the data sent protected?
The information is used solely to review the request and is passed only to the insurers consulted. Calls are made over HTTPS and authenticated by API key.
Planning an integration? Let's talk.