GET /acheteurs/{siret}
Fiche d'un acheteur
Identifiant d'opération : getAcheteur
Un acheteur public par SIRET : identité (nom, type d'organisme, departement, ville), statistiques de son historique de marchés (données essentielles de la commande publique : nombre et montant des contrats, montant médian, durée moyenne, part de PME, nombre moyen d'offres, procédures, CPV principaux, croissance sur 12 mois, dernier contrat), principaux_titulaires (10 au plus : SIRET, nom, nombre de contrats ; titulaires non diffusibles écartés) et avis_ouverts (avis ouverts des sources servies à la clé, sans doublons ni avis d'attribution). statistiques vaut null quand l'acheteur n'a pas d'historique de marchés (environ un tiers des fiches). Quand le SIRET demandé est celui d'un doublon, la réponse est la fiche de référence : siret peut donc différer du SIRET demandé, et liens.fiche (la fiche publique du site) porte le SIRET de la réponse. Aucun champ de contact (e-mail, téléphone, adresse) n'est rendu. SIRET qui n'a pas exactement 14 chiffres : 400, sans lecture. SIRET inconnu : 404. Jamais gardé en mémoire. Périmètre requis : acheteurs:read (403 si la clé ne le porte pas). Quota : réserve per_page enregistrements (1 pour un détail) de la famille general ; 429 quota_exceeded une fois la limite journalière atteinte.
Clé requise, périmètre acheteurs:read.
Paramètres
| Nom | Emplacement | Obligatoire | Type | Description |
|---|---|---|---|---|
siret | path | oui | string | SIRET de l'acheteur, exactement 14 chiffres (fin de l'adresse /acheteurs/{siret} du site). Il s'obtient dans acheteur.siret d'un avis, ou dans principaux_acheteurs d'une fiche prestataire. |
Réponses
| Code | Description |
|---|---|
| 200 | Succès. |
| 400 | invalid_parameter : Paramètre invalide. |
| 401 | unauthorized : Clé d'API manquante ou invalide. |
| 403 | forbidden : Accès refusé : compte non Pro ou périmètre de la clé insuffisant. |
| 404 | not_found : Ressource introuvable. |
| 429 | quota_exceeded : Quota journalier atteint. Il se renouvelle à minuit UTC. ; rate_limited : Trop de requêtes. Réessayez plus tard. |
| 503 | unavailable : Service momentanément indisponible. |
Exemple
curl -H "X-API-Key: pk_live_VOTRE_CLE" "https://publikconnect.fr/api/v1/acheteurs/VOTRE_SIRET"Demander une clé
Avoir un compte Pro
La clé est réservée aux comptes au plan Pro.
Écrire au support
Nous vérifions votre compte Pro puis vous répondons par e-mail avec votre clé.