API partenaires

Commandez des notes d'urbanisme depuis votre système

Une API REST pour intégrer la note de renseignements d'urbanisme à votre logiciel : une requête, un document PDF, le même contenu que sur noteurba.fr.

Documentation OpenAPI Demander un accès

Trois façons de localiser

Référence cadastrale, adresse postale ou coordonnées GPS : l'API résout la parcelle et vous répond immédiatement si elle est introuvable.

Aucune commande perdue

Chaque requête est enregistrée avant d'être traitée. Si la génération échoue, la commande est conservée avec sa demande, reprise automatiquement et relançable.

Jamais de doublon

Rejouer un appel après une coupure réseau renvoie la commande existante : votre numéro de commande sert de clé d'idempotence.

Webhooks signés

Nous vous prévenons dès que le document est prêt ou en échec, par un appel signé en HMAC-SHA256 que vous vérifiez de votre côté.

Document à vos couleurs

La note peut être produite dans un gabarit à votre charte, pour s’insérer dans votre propre famille de documents.

Accès par clé

Une clé d'API par compte, révocable à tout moment, transmise une seule fois et jamais stockée en clair chez nous.

Points d'accès

Tous les appels sont authentifiés par votre clé d'API, en HTTPS.

POST/api/v1/commandes
Commander une NRU — par parcelle, adresse ou point GPS
GET/api/v1/commandes
Lister vos commandes, paginées, filtrables par statut et période
GET/api/v1/commandes/{numero_commande}
Rechercher une commande par votre numéro de commande
GET/api/v1/commandes/{numero_commande}/pdf
Télécharger le document
POST/api/v1/commandes/{numero_commande}/relance
Relancer une commande en échec
POST/api/v1/check
Vérifier qu’une commande est réalisable, sans commander

Exemple

La commande est enregistrée immédiatement ; le document est prêt en général en moins d'une minute. Suivez-la par son numéro, ou attendez notre webhook.

Requête

curl -X POST \
  https://noteurba.fr/api/v1/commandes \
  -H "Authorization: Bearer nu_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "numero_commande": "CMD-0142",
    "parcelle": {
      "reference": "64129000AB0036"
    }
  }'

Réponse

HTTP/1.1 202 Accepted

{
  "numero_commande": "CMD-0142",
  "reference_interne": "NRU-1A2B3C4D5E",
  "statut": "EN_ATTENTE",
  "localisation": {
    "mode": "parcelle",
    "parcelle": "64129000AB0036",
    "commune": "Billère"
  },
  "pdf": null
}

La note est un document d'information : elle ne vaut pas certificat d'urbanisme, seul opposable à l'administration.

Intégrer l'API à votre outil

Les accès sont ouverts sur demande, avec une facturation mensuelle adaptée à vos volumes.

06 12 64 89 40Appel non surtaxé contact@noteurba.fr