Créer un devis

Calcule le prix d'une offre. Le prix est garanti jusqu'à expire_le (15 jours).

POSThttps://api.coveraf.com/v1/devis

SignéRéponse JSON 201Sandbox et production

Le prix vient toujours de l'API

N'envoyez jamais de montant : il est calculé par COVERAF à partir des tarifs officiels, et tout montant envoyé est ignoré. Les champs de donnees dépendent du produit : voir Produits.

En-têtes

En-tête	Obligatoire	Valeur
`Authorization`	oui	Bearer suivi de votre clé API (`cvr_test_...` ou `cvr_live_...`).
`Content-Type`	oui	`application/json`
`X-Coveraf-Timestamp`	oui	Heure actuelle, horodatage Unix en secondes.
`X-Coveraf-Signature`	oui	`v1=` suivi du HMAC-SHA256 de la requête. Comment signer

Corps de la requête

Champ	Type	Obligatoire	Description
`offre`	texte	oui	Code de l'offre (GET /v1/produits).
`donnees`	objet	oui	Informations de tarification, propres à chaque produit (voir la page du produit).
`reference_partenaire`	texte	non	Votre propre référence (commande, client...), 100 caractères maximum.

Exemple de requête

./coveraf.sh POST /v1/devis '{"offre":"securvie_500k","donnees":{"assure":{"date_naissance":"1985-06-15"}},"reference_partenaire":"CMD-2026-0042"}'

Les fonctions appelCoveraf, appel_coveraf et le script coveraf.sh signent la requête pour vous : téléchargez-les.

Réponse

Succès (201), réponse réelle de la sandbox

{
  "id": "dev_68e56446d4b5c6875911f178",
  "objet": "devis",
  "environnement": "test",
  "offre": "securvie_500k",
  "produit": "vie",
  "prime": {
    "nette": 11000,
    "accessoires": 0,
    "taxes": 1980,
    "totale": 12980,
    "devise": "XOF"
  },
  "duree_mois": 12,
  "detail": null,
  "donnees": {
    "assure": {
      "date_naissance": "1985-06-15"
    }
  },
  "reference_partenaire": "CMD-2026-0042",
  "expire_le": "2026-11-19T17:35:33.439+00:00",
  "expire": false,
  "cree_le": "2026-11-04T17:35:33.447204+00:00"
}

Description de chaque champ : modèle Devis.

Erreurs possibles

Code	HTTP	Signification
`validation`	422	Certaines données sont manquantes ou incorrectes. Voir erreur.details.
`non_eligible`	422	Une personne ne remplit pas les conditions de cette offre.
`etude_particuliere`	422	Ce risque dépasse ce que l'offre couvre en ligne : il demande une étude particulière par COVERAF.
`offre_inconnue`	404	Cette offre n'existe pas. Liste des offres : GET /v1/produits.
`offre_non_autorisee`	403	Cette offre n'est pas ouverte à votre compte.
`offre_indisponible`	409	Cette offre est momentanément indisponible à la vente.

S'y ajoutent les erreurs communes à tous les appels (clé, signature, limite de débit, service) : voir Codes d'erreur.