# API Prescriptio

Données publiques du bâti français, recherche d'entreprises, marchés et pièces DCE ; alertes et événements autorisés.

[Connexion et concepts](/docs/reference/concepts.md) · [OpenAPI](/openapi.json) · [Manifeste](/agents/manifest.json)

- [entreprises.search](/docs/api/entreprises.search.md) — Rechercher des entreprises par activité NAF, nom et localisation. Résultats paginés sans coordonnées.
- [entreprises.get](/docs/api/entreprises.get.md) — Consulter une entreprise par SIREN ou un établissement par SIRET. Enveloppe results contenant une fiche.
- [marches.search](/docs/api/marches.search.md) — Rechercher les avis de marchés ; ouvert et avec_dce filtrent des avis et des pièces consultables dans Prescriptio, pas des attributions.
- [dce.read](/docs/api/dce.read.md) — Rechercher dans un dossier ou lire une pièce ciblée. L'identifiant canonique est annonce_id ; les modes sont décrits dans le schéma.
- [dce.download](/docs/api/dce.download.md) — Obtenir un téléchargement autorisé de DCE. Un lien signé est temporaire, ne constitue pas une citation durable et ne doit pas être journalisé.
- [alertes.list](/docs/api/alertes.list.md) — Lister les alertes appartenant à l'utilisateur et à son organisation ; maximum 200.
- [alertes.create](/docs/api/alertes.create.md) — Créer une alerte autorisée. Même nom et mêmes critères : rejeu sans duplication ; critères différents : conflit. Le cron évalue périodiquement, sans garantie de temps réel amont.
- [alertes.delete](/docs/api/alertes.delete.md) — Supprimer une alerte de l'utilisateur ; une suppression répétée est sans effet supplémentaire.
- [events.subscribe](/docs/api/events.subscribe.md) — Créer un abonnement de polling à une alerte active. Premier démarrage : événements futurs seulement. Conserver une clé stable par automatisation.
- [events.poll](/docs/api/events.poll.md) — Lire au plus 100 événements après un checkpoint propre à l'abonnement. Rejouer un checkpoint retourne les mêmes identifiants ; aucun acquittement implicite.
- [events.revoke](/docs/api/events.revoke.md) — Révoquer un abonnement. Les prochains polls sont refusés immédiatement.
- [events.ack](/docs/api/events.ack.md) — Acquitter un événement après traitement réussi. Chaque ack_token est lié à l'abonnement et à l'événement ; les acquittements hors ordre ne perdent pas les événements précédents.

Les outils historiques sont inventoriés séparément ; aucune opération d'administration n'est publiée.