Aidez-nous à améliorer data.gouv.fr en répondant à notre enquête annuelle ❤️
République
Française
API BOAMP
Description
Cet API provient d'un service public certifié.
L’API BOAMP est une Interface de Programmation d’Applications permettant d’accéder directement aux annonces du BOAMP en fonction de critères de sélection prédéfinis.
Contenu des données accédées
Créé par le décret n° 57-435 du 4 avril 1957, le BOAMP diffuse les avis d’appel public à la concurrence et les résultats de marchés de l’État, l’armée, les collectivités territoriales et leurs établissements publics. Il publie également des contrats de partenariat public-privé et des avis de concession.
Il est précisé à l’article 33 du décret n° 2016-360 du 25 mars 2016 relatif aux marchés publics qu’une diffusion est obligatoire au BOAMP pour tous les marchés dont le montant est supérieur aux seuils européens. En dessous de ces seuils, une publication reste obligatoire au BOAMP ou dans un journal habilité à recevoir des annonces légales. Pour les marchés à procédure adaptée (MAPA) inférieurs à 90 000 € HT, l’acheteur public a le choix des supports qu’il utilisera pour assurer la publicité de ses marchés.
Les données du boamp sont diffusées sur le site le jour de publication 2 fois par jour, 7 jours/7.
Précisions API BOAMP
Vous pouvez accéder à l'ensemble des annonces via cette API.
Les résultats peuvent être obtenus, à la demande, en CSV, en JSON ou au format EXCEL.
La description du modèle de données de l’API se trouve ici.
Utilisation
L’utilisation de l’API BOAMP se fait en deux temps :
- Lancement d’une requête d’interrogation/filtrage avec récupération de l’identifiant d’une annonce ;
- Lancement d’une requête de récupération des données complètes en passant en paramètre un identifiant d’annonce et une version d’API correspondant à celle-ci.
Accéder à l'historique des annonces, des schémas de données et de la documentation.
Pour en savoir plus sur l'API BOAMP
Pour toute demande de support vous pouvez nous écrire à : donnees-dila@dila.gouv.fr
- Producteur
- Dernière mise à jour
- 13 décembre 2025
Vues
0
Téléchargements
0
Qualité des métadonnées:
Votre question porte sur autre chose que ce jeu de données ? Visiter notre forum
8 discussions
Demande des documents associés à un appel d’offres
Je vous contacte afin d'obtenir les documents associés à un appel d’offres spécifique disponible sur le site BOAMP.J’aimerais récupérer les documents attachés à une offre donnée.
Pourriez-vous me fournir des informations sur la manière d’accéder à ces documents via l’API BOAMP ? Si un identifiant spécifique est nécessaire pour accéder aux pièces jointes ou si des étapes particulières doivent être suivies, merci de bien vouloir m'en informer.
Je vous remercie par avance pour votre aide et votre retour. Je reste à votre disposition pour toute précision complémentaire.
Cordialement,
Ilyas Makhloul
Erreur dans les blocs "gestion" et "donnees" : guillemets en trop
Bonjour,
Les blocs "gestion" et "donnees" contient des guillemets en trop gavant la première accolade générant une erreur lors du parsing :
"gestion":"{"NOJO": "BXP06080030262E"
"donnees":"{"INFO": {"FOURNITURES": "",
Merci d'avance pour votre correction.
Bonjour,
Merci pour votre remarque.
Nous avons transmis votre message au service compétent.
Cordialement,
Administration des données
Direction de l'information légale et administrative (DILA)
Bonjour,
Vous trouverez les éléments de réponse transmis par le service compétent.
Ces 2 colonnes sont du type string mais contiennent effectivement des objets json.
Il faut utiliser une conversion string to json avant de pouvoir les manipuler en tant qu’objet.
Opendatasoft ne gère pas de type colonne spécifique pour exposer des colonnes de type objet json autrement qu’en string.
Cordialement,
Administration des données
Direction de l'information légale et administrative (DILA)
Merci pour votre réactivité, c'est dommage mais OK nous ferons avec.
Erreur 404 sur test API
Bonjour,
J'ai pu tester votre API complète il y'a quelques jours sans aucun problème. Depuis hier, le 10/05/2023, lors de tous les test j'obtiens une erreur 404. Pour information, j'utilise l'API complète V2.0 (https://boamp-datadila.opendatasoft.com/api/explore/v2.0/console). toutes mes requetes donnent comme résultat :
Server response
Code Details
404
Undocumented
Error: response status is 404
Je n'avais pas cette erreur avant hier. Pourriez-vous me dire si cela est normal et peut être lié à un disfonctionnement de l'API ? Par avance je vous en remercie.
Cordialement.
Bonjour,
Pouvez-vous nous donner un exemple de requête qui tombe en 404 ?
Par avance merci.
Cordialement,
Administration des données
Direction de l'information légale et administrative (DILA)
Bonjour. Merci pour votre réponse rapide. Absolument toutes les requêtes tombent en 404 ce qui n'était pas le cas il y'a quelques jours. Une requête a vide sans critere tombe en 404 également. Bien à vous.
Je viens de tester a l'instant de mon téléphone et tout semble fonctionner à nouveau. Ce matin je tombais encore en 404. Merci beaucoup. Bon week end a vous.
Merci pour votre message.
Bon week-end également,
Cordialement,
Administration des données
Direction de l'information légale et administrative (DILA)
Des v110 au milieu des v230 ?
DELETED
DELETED
Bonjour,
Le critère schéma v230 correspond aux annonces depuis mars 2015.
La version V010 pour les annonces dites MAPA de 2006 à 2007.
La version V110 pour les annonces de 2006 à mars 2015 hors MAPA V010.
Cordialement,
Administration des données
DILA
DELETED
Structuration des données
Bonjour,
Nous avons pour objectif de récupérer un certains nombre d'éléments propres aux marchés, notamment l'attributaire ainsi que la date d'attribution et la durée du marché.
Pour l'instant nous ne travaillons qu'avec la v110.
Or lorsque nous récupérons les données dans un fichier csv, nous faisons face à deux types de problèmes :
- la structuration des données peut varier selon les marchés (pour un même type de données, la colonne n'est pas la même) ;
- certains données qui semblent être présentes dans la version online du BOAMP n'apparaissent pas à travers les remontées de l'API (par exemple, la date d'attribution du marché).
Dès lors, nous souhaiterions avoir des informations supplémentaire concernant la la structuration des avis présentés sur le site du BOAMP, alors que les données disponibles à travers l'API ne semblent pas structurellement uniformisées.
Vous remerciant par avance.
Bonjour,
Il y 3 API avec des noms de versions différents : V230, V010, V110.
Chaque version correspond à une période à laquelle une annonce a été passée.
La V230 correspond aux annonces parues depuis le 1er mars 2015 : si vous recherchez une annonce parue à partir de cette date, votre requête doit utiliser cette version.
La V010 correspond aux annonces MAPA parues en 2006 et 2007 ;
La V110 correspond aux annonces hors MAPA parues en 2006 et 2007 et à toutes les annonces parues de 2008 à fin février 2015.
Si vous cherchez une annonce sur la période 2006 à février 2015, il se peut que les résultats soient erronés : ceci est dû aux nombreux changements qu’ont connus les formats d’annonce au fil du temps.
Pour cette raison, l’utilisation de la V010 et de la V110 n’est pas supportée par la DILA.
Nous vous recommandons de ne pas utiliser ces versions de l’API et de procéder au téléchargement des annonces de cette période en suivant le lien vers le site de téléchargement.
Cordialement.
Administration des données
données API: exhaustivité des champs
Bonjour,
Existe-il un document présentant l'ensemble des données disponibles sur l'api v230 avec l'arborescence. En consultant plusieurs ID je m'aperçois que des données existent en fonction des ID et de la façon dont l'avis a été renseigné.
Mon objectif étant d'avoir une exhaustivité au niveau des champs (ou données) disponibles pour l'API V230.
En vous remerciant.
defaut dans l'api... rensrecours
encore moi... (décidement)
lorsque l'on "parse" le json envoyé apres une requete à votre API, le champs "rensrecours" reste "null" alors qu'il y a des renseignement de recours ( denomination : "tribunal administratif de ...." )
de plus c'est dommage que les informations de recours (denomination du tribunal, code postal, ville ect...) on le meme nom que la denomination de l'organisme qui passe le marché
Nous n'arrivons pas à rejouer le cas présenté.
Pourriez vous nous fournir un idweb dans lequel l’information de rensrecours serait présente en xml et pas en json ?
Critères de requetes de l'API
Bonjour
Je lis vos documentations pour apprendre à faire des requetes sur votre API.
Cependant, je n'arrive pas à trouver la liste de tout les criteres possible qu'il est possible d'envoyer dans une requete.
Vos documentation n'indiquent que quelques critères dans la partie "exemple"
ces criteres sont :
- source_cat
- idweb
- devise
- famille_cat
existent-ils d'autres critères de recherche?
merci pour votre reponse
Cordialement
je reviens encore vers vous car j'ai encore une question
Il y a 3 version ( v010, v110, et v230) que l'on peux specifier dans la requete à l'api
pour requeter à l'api, on specifie la version
par exemple pour la v010 : source_cat:0
mais pour la v230 il y a deux parametre qui donnent des nombres de resultats differents
source-cat:2 et source_cat:3
la v230 est-elle "splitée" en deux? merci encore pour vos reponses
Critères de requête de l'API :
La liste des champs utilisables dans les requêtes sont les suivants :
datamodel_class:Category
datamodel_class_hierarchy:Category
text - default : text
boamp_analysisdate: Date
boamp_objetmarche: Text
boamp_critere_environnemental:Text
boamp_datefindiffusion:Date
boamp_idweb:Text
boamp_nature:Text
boamp_nomacheteur:Text
boamp_status_initial:Text
boamp_status_rectificatif:Text
boamp_titulaire:Text
boamp_xmlbody:Text
boamp_numerodepartement:Text
boamp_numeroregion:Text
boamp_criteres_cat:Category
boamp_etat_cat:Category
boamp_nature_cat:Category
boamp_genre_cat:Text
boamp_rappel_cat:Category
boamp_procedure_cat:Text
boamp_perimetre_cat:Category
boamp_annonceref:Text
boamp_datelimitereponse:Date
boamp_xmlbody_text:Text
boamp_caracteristiques_principales:Text
boamp_lots_descriptions:Text
boamp_lots_intitules:Text
boamp_titre_marche:Text
boamp_type_marche:Text
boamp_entite_adjudicatrice:Text
boamp_pouvoir_adjudicateur:Text
boamp_type_organisme:Text
boamp_type_pouvoir_adjudicateur:Text
boamp_sous_type_marche:Text
boamp_source_cat:Text
boamp_annonceliee:Text
boamp_sousnature:Text
boamp_code_ident_national_acheteur:Text
boamp_file_path:Text
boamp_dateparution:Date
boamp_displayurl:Text
boamp_html_path:Text
boamp_famille_cat:Text
boamp_typemarche_cat:Text
boamp_marchepublicsimplifie_cat:Text
boamp_descripteur:Text
boamp_critere_social:Text
boamp_code_ident_national_titulaire:Text
boamp_status_annulation:Text
boamp_regiondepartement_cat:Text
boamp_devise:Text
boamp_valeur:Numeric
boamp_objet_complet:Text
boamp_lastaccessdate:Date
boamp_lastmodifieddate:Date
boamp_schema:Text
boamp_v1_nom:Text
boamp_v1_recept_offres:Text.
Réponse : La V230 est-elle "splitée en deux :
Non
Pour filtrer les annonces au format v230, nous recommandons d’utiliser le critère suivant schema :*v230*
Et de faire la requête suivante :
schema :*v230* = (boamp_source_cat : 2 OR boamp_source_cat : 3)
Autre exemple :
Si l’on veut connaitre toutes les annonces traitant à la fois de bois et d’acier depuis la version v230 (avril 2015), la requête sera la suivante :
acier AND bois AND schema :*v230*