API marchés publics — France, Espagne, Royaume-Uni, Irlande, Pologne et Norvège

Chaque acheteur public publie ses attributions de son côté : en France dans les données essentielles de la commande publique (DECP), consolidées ; en Espagne sur la Plataforma de Contratación del Sector Público (PLACSP), appels d'offres et petits marchés confondus ; au Royaume-Uni sur Contracts Finder et Find a Tender ; en Irlande, en Pologne et en Norvège sur le TED, au-dessus des seuils européens seulement. Prometiam expose ces attributions dans un seul endpoint REST, interrogeable par acheteur, titulaire, identifiant (SIRET, NIF, numéro Companies House, CRO, NIP ou organisasjonsnummer), code CPV ou date, mis à jour chaque jour depuis les plateformes officielles.

L'endpoint

GET /procurement/awards accepte country (FR, ES, GB, IE, PL ou NO ; sans lui, les six), company_id, nif (l'identifiant du titulaire tel que publié), supplier, buyer, cpv, date_from, date_to, min_amount, limit et cursor ; au moins un de company_id, nif, supplier, buyer, cpv ou date_from est requis. Chaque ligne est une attribution à un titulaire et porte country, company_id, supplier_name, supplier_tax_id, buyer, buyer_id, subject, amount_eur, amount_contract_eur, amount_is_ceiling, amount_suspect, award_date, nature, is_framework, n_suppliers, contract_type, procedure, cpv, bids_received, sme, duration_months, file_reference et source_url, de la plus récente à la plus ancienne.

Limites de périmètre

Six pays : la France et l'Espagne depuis leurs plateformes nationales, le Royaume-Uni depuis Contracts Finder et Find a Tender, l'Irlande, la Pologne et la Norvège depuis le TED, au-dessus des seuils européens seulement. Les montants publiés en livres, en złotys ou en couronnes sont convertis au taux moyen annuel de la BCE de l'année d'attribution ; currency garde la devise publiée, et le Royaume-Uni ne publie un montant que pour une partie de ses attributions. amount_eur est la part du titulaire telle que publiée, hors taxes là où la source le distingue ; amount_contract_eur est le marché entier, compté une seule fois quel que soit le nombre de titulaires. Un accord-cadre ou un système d'acquisition dynamique publie un plafond, pas une dépense, et la ligne le dit avec amount_is_ceiling ; un montant publié qui est une valeur par défaut du formulaire et non un prix porte amount_suspect. La France ne publie le nombre d'offres reçues que pour une partie de ses attributions : bids_received est vide là où il n'a pas été publié, et un vide n'est pas une offre unique. En Espagne, les petits marchés (contratos menores) sont attribués directement par la loi, une offre unique y est donc attendue. company_id n'apparaît que lorsque l'identifiant du titulaire correspond à une entreprise du registre de ce pays — la France, l'Espagne et le Royaume-Uni aujourd'hui ; les lignes irlandaises, polonaises et norvégiennes portent l'identifiant publié sans ce lien — ; sinon, l'attribution est renvoyée quand même. Les attributions à des personnes physiques ne sont jamais renvoyées. Pas de score de crédit, pas de comptes, pas de score de risque.

Cas d'usage

Diligence sur un fournisseur avant de le référencer ou de le financer ; mesurer la dépendance d'un fournisseur à un seul acheteur en agrégeant ses propres lignes ; référencer un acheteur public comme client et voir à qui il attribue ; relier une attribution à la fiche registre de l'entreprise via company_id et GET /companies/{id} pour son statut et ses dirigeants, puis à ses procédures collectives sur GET /insolvency/search?country=FR.

En savoir plus · Obtenir une clé API gratuite

Frequently asked questions

Que couvre cet endpoint ?
Les attributions de marchés publics telles que publiées par chaque acheteur : en France les données essentielles de la commande publique (DECP) consolidées, en Espagne la Plataforma de Contratación del Sector Público (PLACSP), appels d’offres et petits marchés confondus ; au Royaume-Uni Contracts Finder et Find a Tender ; en Irlande, en Pologne et en Norvège le TED, au-dessus des seuils européens seulement. GET /procurement/awards les renvoie interrogeables par acheteur, titulaire, identifiant, code CPV ou date ; country=FR, ES, GB, IE, PL ou NO limite à un pays.
Le montant est-il hors taxes ?
amount_eur est la part du titulaire telle que publiée, hors taxes là où la source le distingue, et amount_contract_eur est le marché entier compté une seule fois. Un accord-cadre ou un système d’acquisition dynamique publie un plafond, pas une dépense, et la ligne le dit avec amount_is_ceiling — ne le lisez pas comme un chiffre d’affaires réel.
Une offre unique est-elle un signal de risque ?
Pas à elle seule. La France ne publie le nombre d’offres reçues que pour une partie de ses attributions : un bids_received vide ne signifie pas une offre unique. En Espagne, les petits marchés sont attribués directement par la loi, une offre unique y est donc attendue. L’endpoint ne marque rien comme suspect : il renvoie des lignes, sans scoring.
Puis-je relier une attribution à la fiche registre de l’entreprise ?
Oui, lorsque l’identifiant du titulaire correspond à une entreprise du registre de ce pays (la France, l’Espagne et le Royaume-Uni aujourd’hui ; les lignes irlandaises, polonaises et norvégiennes portent l’identifiant sans ce lien) : la ligne porte company_id, et GET /companies/{id} donne le statut et les dirigeants ; les procédures collectives françaises sont sur GET /insolvency/search?country=FR. Sans correspondance, l’attribution est renvoyée quand même, sans ce lien.
Cela remplace-t-il une analyse de risque de crédit ?
Non. L’endpoint renvoie des attributions publiées, sans comptes, sans scoring et sans aucun score de risque. C’est un signal de plus dans un processus de diligence, pas un verdict. Une lecture notée de l’acheteur lui-même est l’objet des endpoints de risque acheteur public, en bêta.