API REST CaledoLegales

Acces programmatique aux fiches entreprises NC, annonces legales et recherche. Versionnee, documentee, gratuite jusqu'a 1 000 appels/jour pour les abonnes Equipe.

Pre-lancement. L'API est en cours d'implementation. La documentation ci-dessous reflete le contrat final. Endpoint https://api.caledolegales.com/v1/... live au lancement (mi-2026).

Authentification

L'API publique en lecture est ouverte sans cle pour les fiches et annonces (sous rate-limit anonymous 60 req/h). Pour les usages volumineux ou les endpoints abonnes, ajoutez votre cle dans l'header X-API-Key ou Authorization: Bearer <cle>. Cles disponibles dans votre espace abonne (plan Equipe uniquement).

Endpoints

GET/v1/entreprises/:ridetPublic

Recupere une fiche entreprise complete avec son historique d'annonces (50 dernieres).

:ridet: RIDET au format 10 chiffres sans espaces (ex: 1648294001)

curl https://api.caledolegales.com/v1/entreprises/1648294001

GET/v1/annoncesPublic

Liste les annonces legales, triees par date desc. Filtres optionnels.

?type: creation, capital, siege, statuts, nomination, cession, procedure, dissolution
?source: JONC, LNC, ProvinceSud, ProvinceNord, ProvinceIles, ...
?since: date ISO (annonces depuis cette date)
?limit: 1-100, defaut 20

curl "https://api.caledolegales.com/v1/annonces?type=procedure&limit=10"

GET/v1/searchPublic

Recherche full-text dans les denominations et RIDETs des entreprises NC.

?q: requete texte (min 2 caracteres)

curl "https://api.caledolegales.com/v1/search?q=conseil"

Webhooks (plan Pro & Equipe)

POST<votre webhook URL>Cle requise

Quand une annonce concernant un RIDET surveille est detectee, nous appelons votre webhook avec ce payload :

{
  "event": "annonce.created",
  "ridet": "1234567890",
  "denomination": "Pacifique Conseil SARL",
  "type": "capital",
  "titre": "Augmentation de capital",
  "resume": "AGE du 28 mars...",
  "date": "2026-04-15",
  "source": "JONC",
  "fiche_url": "https://caledolegales.com/entreprise.html?ridet=1234567890"
}

Header inclus : X-CaledoLegales-Event: annonce.created. Signature HMAC SHA-256 dans X-CaledoLegales-Signature (plan Equipe).

Widget embarquable

/widget.html?ridets=<liste>Public

Affiche les dernieres annonces d'une selection de RIDETs. Integrable en iframe sur n'importe quel site (cabinet d'avocats, banque, ERP interne).

<iframe src="https://caledolegales.com/widget.html?ridets=1234567890,2345678901&limit=5" width="100%" height="420" frameborder="0"></iframe>

Limites & quotas

Anonyme : 60 req/h. Plan Veille : 1 000 req/jour. Plan Pro : 5 000 req/jour. Plan Equipe : 50 000 req/jour + cle authentifiee + webhooks signes.

Demarrer maintenant

Reservez votre place sur la waiting-list pour acceder en avant-premiere a l'API au lancement.

Rejoindre la waiting-list →