Documentation API

Documentation

Quickstart & référence API

Une API REST, deux façons de vous authentifier, le même périmètre complet.

Base URL · https://api.datenza.com/v1

Quickstart

Choisissez une offre API payante, générez une clé, faites votre premier appel. L'enveloppe de réponse est cohérente sur tous les endpoints.

cURL

curl https://api.datenza.com/v1/entreprises/552081317 \
  -H "Authorization: Bearer dtz_test_xxx"

Authentification

Choisissez selon votre niveau d'exigence, pas selon les fonctionnalités.

API key

Pour le bootstrap, les scripts internes et les intégrations légères.

RFC 9421

Anti-rejeu, Content-Digest (RFC 9530), réponses signées et liées à la requête.

Endpoints

GET	/v1/recherche	Rechercher des entreprises par nom, identifiant ou dirigeant, avec filtres.
GET	/v1/entreprises/{siren}	Récupérer le dossier d'une entreprise (param inclure pour dirigeants, comptes, actes).
GET	/v1/dirigeants	Rechercher des dirigeants et leurs mandats.
GET	/v1/entreprises/{siren}/comptes	Comptes annuels et données financières déposées.
GET	/v1/entreprises/{siren}/documents	Liste et téléchargement des actes, statuts et comptes.
POST	/v1/surveillance	Ajouter une entité au portefeuille surveillé et déclarer un webhook.
POST	/v1/attestations	Générer une attestation scellée et horodatée à valeur probante.

Webhooks

Déclarez une callback_url : nous y postons chaque événement légal (modification, cession, procédure), signé pour que vous puissiez l'authentifier.

POST /v1/surveillance

{
  "siren": "552081317",
  "callback_url": "https://votre-app.fr/webhooks/datenza"
}

Erreurs

En cas d'erreur, success vaut false avec un message lisible.

Code	Signification
401	Authentification manquante ou invalide
403	Signature ou nonce rejeté (anti-rejeu)
404	Entreprise introuvable
429	Cadence trop élevée, réessayez après le délai indiqué

Une clé API payante en deux minutes, avec toute la doc pour démarrer.