When should you use this API?
Use cases and limitations are published with the API so humans and agents can integrate it correctly.
Use when
- You need company-specific actionable opportunities combining public aid matching and currently open public tenders.
- You want opportunities ranked from the company profile, optional project context and historical public-contract evidence.
Avoid when
- You need a broad open-tender search without company context; use procurement/fr/search.
- You need a guarantee of aid eligibility, tender suitability or commercial success.
Limitations
- PUBLIC_AID opportunities are produced only when a project is provided and matches the public taxonomy; they remain indicative, not official eligibility decisions.
- PUBLIC_TENDER matching is intentionally conservative and relies on common CPV codes plus shared business vocabulary with historical awarded contracts; source coverage can be partial.
Sources and provenance
Sources published for this endpoint are shown directly with their original link.
API Recherche d'entreprises
recherche-entreprises.api.gouv.fr
Aides-entreprises.fr — stock public des aides
data.aides-entreprises.fr:aides
Données essentielles de la commande publique (DECP)
data.economie.gouv.fr:decp-2022-marches-valides
BOAMP Open Data
boamp-datadila.opendatasoft.com:boamp
Stored real response
This snapshot is served from published database data without executing the paid API.
Request
{
"identifier": "356000000",
"project": "transformation numérique",
"limit": 10
}Stored response
{
"identifier": "356000000",
"identifier_type": "siren",
"exists": true,
"siren": "356000000",
"name": "LA POSTE",
"company_status": "active",
"project": "transformation numérique",
"total_candidates": 10,
"returned_count": 10,
"truncated": true,
"opportunities": [
{
"type": "PUBLIC_TENDER",
"score": 1,
"title": "Le marché porte sur la collecte, remise, affranchissement et routage de courriers et colis",
"reasons": [
"Le code CPV 64100000 figure à la fois dans un marché public déjà attribué à cette entreprise et dans cet appel d’offres ouvert.",
"Le libellé de l’appel d’offres partage un vocabulaire métier avec les marchés déjà remportés : collecte, remise, colis."
],
"source_data": {
"matching_cpv": "64100000",
"matching_terms": [
"collecte",
"remise",
"colis"
],
"tender": {
"id": "26-81268",
"object": "Le marché porte sur la collecte, remise, affranchissement et routage de courriers et colis",
"publication_date": "2026-08-19",
"deadline": "2026-09-21T11:00:00+00:00",
"days_remaining": 18,
"buyer": "OPCO SANTE",
"departments": [
"75",
"92"
],
"procedure_code": "AUTRE",
"procedure": "Procédure NC",
"notice_type": "Avis de marché",
"market_types": [
"SERVICES"
],
"criteria": [
"sociaux",
"environnementaux"
],
"descriptors": [
{
"code": "65",
"label": "Colis"
},
{
"code": "312",
"label": "Routage"
}
],
"cpv_codes": [
"64100000",
"64113000"
],
"url": "https://www.boamp.fr/pages/avis/?q=idweb:26-81268",
"source": "boamp-datadila.opendatasoft.com:boamp",
"source_type": "SOURCE_PUBLIQUE"
}
},
"sources": [
"company/fr/public-contracts",
"procurement/fr/search"
]
},
{
"type": "PUBLIC_TENDER",
"score": 1,
"title": "COLLECTE, ACHEMINEMENT ET DISTRIBUTION DES CORRESPONDANCES ET COLIS DE TOUS FORMATS AFFRANCHIS PAR LE SERVICE ACCUEIL TELEPHONIQUE ET COURRIER DU DEPARTEMENT DE L’OISE ET FOURNITURE DE TIMBRES ET DE",
"reasons": [
"Le code CPV 64100000 figure à la fois dans un marché public déjà attribué à cette entreprise et dans cet appel d’offres ouvert.",
"Le libellé de l’appel d’offres partage un vocabulaire métier avec les marchés déjà remportés : collecte, distribution, colis, courrier."
],
"source_data": {
"matching_cpv": "64100000",
"matching_terms": [
"collecte",
"distribution",
"colis",
"courrier"
],
"tender": {
"id": "26-83422",
"object": "COLLECTE, ACHEMINEMENT ET DISTRIBUTION DES CORRESPONDANCES ET COLIS DE TOUS FORMATS AFFRANCHIS PAR LE SERVICE ACCUEIL TELEPHONIQUE ET COURRIER DU DEPARTEMENT DE L’OISE ET FOURNITURE DE TIMBRES ET DE",
"publication_date": "2026-08-27",
"deadline": "2026-09-29T15:00:00+00:00",
"days_remaining": 26,
"buyer": "Département de l'Oise",
"departments": [
"60"
],
"procedure_code": "OUVERT",
"procedure": "Procédure Ouverte",
"notice_type": "Avis de marché",
"market_types": [
"SERVICES"
],
"criteria": [],
"descriptors": [
{
"code": "274",
"label": "Prestations de services"
}
],
"cpv_codes": [
"60160000",
"60411000",
"64100000",
"64121100"
],
"url": "https://www.boamp.fr/pages/avis/?q=idweb:26-83422",
"source": "boamp-datadila.opendatasoft.com:boamp",
"source_type": "SOURCE_PUBLIQUE"
}
},
"sources": [
"company/fr/public-contracts",
"procurement/fr/search"
]
},
{
"type": "PUBLIC_TENDER",
"score": 1,
"title": "MISE EN PAGE, IMPRESSION ET DISTRIBUTION DE MAGAZINES ET EMAG DU CONSEIL DEPARTEMENTAL DU GARD",
"reasons": [
"Le code CPV 64121100 figure à la fois dans un marché public déjà attribué à cette entreprise et dans cet appel d’offres ouvert.",
"Le libellé de l’appel d’offres partage un vocabulaire métier avec les marchés déjà remportés : distribution, conseil, departemental."
],
"source_data": {
"matching_cpv": "64121100",
"matching_terms": [
"distribution",
"conseil",
"departemental"
],
"tender": {
"id": "26-76823",
"object": "MISE EN PAGE, IMPRESSION ET DISTRIBUTION DE MAGAZINES ET EMAG DU CONSEIL DEPARTEMENTAL DU GARD",
"publication_date": "2026-08-02",
"deadline": "2026-09-16T14:00:00+00:00",
"days_remaining": 13,
"buyer": "Conseil départemental du Gard",
"departments": [
"30"
],
"procedure_code": "OUVERT",
"procedure": "Procédure Ouverte",
"notice_type": "Avis de marché",
"market_types": [
"SERVICES"
],
"criteria": [
"environnementaux"
],
"descriptors": [
{
"code": "160",
"label": "Impression"
},
{
"code": "274",
"label": "Prestations de services"
}
],
"cpv_codes": [
"64121100",
"79810000",
"79822500",
"79824000"
],
"url": "https://www.boamp.fr/pages/avis/?q=idweb:26-76823",
"source": "boamp-datadila.opendatasoft.com:boamp",
"source_type": "SOURCE_PUBLIQUE"
}
},
"sources": [
"company/fr/public-contracts",
"procurement/fr/search"
]
},
{
"type": "PUBLIC_TENDER",
"score": 0.94,
"title": "Impression et distribution du magazine d'information départemental",
"reasons": [
"Le code CPV 64100000 figure à la fois dans un marché public déjà attribué à cette entreprise et dans cet appel d’offres ouvert.",
"Le libellé de l’appel d’offres partage un vocabulaire métier avec les marchés déjà remportés : distribution, information."
],
"source_data": {
"matching_cpv": "64100000",
"matching_terms": [
"distribution",
"information"
],
"tender": {
"id": "26-82254",
"object": "Impression et distribution du magazine d'information départemental",
"publication_date": "2026-08-23",
"deadline": "2026-09-25T14:00:00+00:00",
"days_remaining": 22,
"buyer": "Département du Rhône",
"departments": [
"69"
],
"procedure_code": "OUVERT",
"procedure": "Procédure Ouverte",
"notice_type": "Avis de marché",
"market_types": [
"FOURNITURES"
],
"criteria": [],
"descriptors": [
{
"code": "160",
"label": "Impression"
}
],
"cpv_codes": [
"22213000",
"64100000",
"79810000"
],
"url": "https://www.boamp.fr/pages/avis/?q=idweb:26-82254",
"source": "boamp-datadila.opendatasoft.com:boamp",
"source_type": "SOURCE_PUBLIQUE"
}
},
"sources": [
"company/fr/public-contracts",
"procurement/fr/search"
]
},
{
"type": "PUBLIC_TENDER",
"score": 0.94,
"title": "Conception graphique, impression et distribution du magazine municipal Le Columérin",
"reasons": [
"Le code CPV 64121100 figure à la fois dans un marché public déjà attribué à cette entreprise et dans cet appel d’offres ouvert.",
"Le libellé de l’appel d’offres partage un vocabulaire métier avec les marchés déjà remportés : distribution, magazine."
],
"source_data": {
"matching_cpv": "64121100",
"matching_terms": [
"distribution",
"magazine"
],
"tender": {
"id": "26-69205",
"object": "Conception graphique, impression et distribution du magazine municipal Le Columérin",
"publication_date": "2026-07-12",
"deadline": "2026-09-10T10:00:00+00:00",
"days_remaining": 7,
"buyer": "Mairie de Colomiers",
"departments": [
"31"
],
"procedure_code": "OUVERT",
"procedure": "Procédure Ouverte",
"notice_type": "Avis de marché",
"market_types": [
"SERVICES"
],
"criteria": [
"environnementaux"
],
"descriptors": [
{
"code": "285",
"label": "Publicité, Communication"
}
],
"cpv_codes": [
"64121100",
"79800000",
"79822500",
"79824000"
],
"url": "https://www.boamp.fr/pages/avis/?q=idweb:26-69205",
"source": "boamp-datadila.opendatasoft.com:boamp",
"source_type": "SOURCE_PUBLIQUE"
}
},
"sources": [
"company/fr/public-contracts",
"procurement/fr/search"
]
},
{
"type": "PUBLIC_TENDER",
"score": 0.94,
"title": "Distribution de documents non adressés toutes boites sur l'ensemble du Département",
"reasons": [
"Le code CPV 64121100 figure à la fois dans un marché public déjà attribué à cette entreprise et dans cet appel d’offres ouvert.",
"Le libellé de l’appel d’offres partage un vocabulaire métier avec les marchés déjà remportés : distribution, boites."
],
"source_data": {
"matching_cpv": "64121100",
"matching_terms": [
"distribution",
"boites"
],
"tender": {
"id": "26-74514",
"object": "Distribution de documents non adressés toutes boites sur l'ensemble du Département",
"publication_date": "2026-07-26",
"deadline": "2026-09-11T10:00:00+00:00",
"days_remaining": 8,
"buyer": "Conseil départemental du Loiret",
"departments": [
"45"
],
"procedure_code": "OUVERT",
"procedure": "Procédure Ouverte",
"notice_type": "Avis de marché",
"market_types": [
"SERVICES"
],
"criteria": [],
"descriptors": [
{
"code": "274",
"label": "Prestations de services"
}
],
"cpv_codes": [
"64121100"
],
"url": "https://www.boamp.fr/pages/avis/?q=idweb:26-74514",
"source": "boamp-datadila.opendatasoft.com:boamp",
"source_type": "SOURCE_PUBLIQUE"
}
},
"sources": [
"company/fr/public-contracts",
"procurement/fr/search"
]
},
{
"type": "PUBLIC_TENDER",
"score": 0.94,
"title": "Edition et diffusion du magazine municipal de la Ville de Lyon",
"reasons": [
"Le code CPV 64121100 figure à la fois dans un marché public déjà attribué à cette entreprise et dans cet appel d’offres ouvert.",
"Le libellé de l’appel d’offres partage un vocabulaire métier avec les marchés déjà remportés : edition, magazine."
],
"source_data": {
"matching_cpv": "64121100",
"matching_terms": [
"edition",
"magazine"
],
"tender": {
"id": "26-85108",
"object": "Edition et diffusion du magazine municipal de la Ville de Lyon",
"publication_date": "2026-09-03",
"deadline": "2026-10-02T14:00:00+00:00",
"days_remaining": 29,
"buyer": "Ville de Lyon",
"departments": [
"69"
],
"procedure_code": "OUVERT",
"procedure": "Procédure Ouverte",
"notice_type": "Avis de marché",
"market_types": [
"SERVICES"
],
"criteria": [
"sociaux",
"environnementaux"
],
"descriptors": [
{
"code": "104",
"label": "Edition"
},
{
"code": "160",
"label": "Impression"
},
{
"code": "274",
"label": "Prestations de services"
}
],
"cpv_codes": [
"22120000",
"64121100",
"79800000",
"79970000"
],
"url": "https://www.boamp.fr/pages/avis/?q=idweb:26-85108",
"source": "boamp-datadila.opendatasoft.com:boamp",
"source_type": "SOURCE_PUBLIQUE"
}
},
"sources": [
"company/fr/public-contracts",
"procurement/fr/search"
]
},
{
"type": "PUBLIC_TENDER",
"score": 0.88,
"title": "PRESTATIONS DE COURRIER ET DE LOCATION ET MAINTENANCE DE MACHINES A AFFRANCHIR POUR LE CONSEIL DEPARTEMENTAL D'EURE-ET-LOIR",
"reasons": [
"Le code CPV 64100000 figure à la fois dans un marché public déjà attribué à cette entreprise et dans cet appel d’offres ouvert.",
"Le libellé de l’appel d’offres partage un vocabulaire métier avec les marchés déjà remportés : courrier."
],
"source_data": {
"matching_cpv": "64100000",
"matching_terms": [
"courrier"
],
"tender": {
"id": "26-74773",
"object": "PRESTATIONS DE COURRIER ET DE LOCATION ET MAINTENANCE DE MACHINES A AFFRANCHIR POUR LE CONSEIL DEPARTEMENTAL D'EURE-ET-LOIR",
"publication_date": "2026-07-28",
"deadline": "2026-09-10T10:00:00+00:00",
"days_remaining": 7,
"buyer": "Conseil départemental d'Eure-et-Loir",
"departments": [
"28"
],
"procedure_code": "OUVERT",
"procedure": "Procédure Ouverte",
"notice_type": "Avis de marché",
"market_types": [
"SERVICES"
],
"criteria": [
"environnementaux"
],
"descriptors": [
{
"code": "274",
"label": "Prestations de services"
}
],
"cpv_codes": [
"30131400",
"64100000",
"64120000"
],
"url": "https://www.boamp.fr/pages/avis/?q=idweb:26-74773",
"source": "boamp-datadila.opendatasoft.com:boamp",
"source_type": "SOURCE_PUBLIQUE"
}
},
"sources": [
"company/fr/public-contracts",
"procurement/fr/search"
]
},
{
"type": "PUBLIC_TENDER",
"score": 0.88,
"title": "2026A0222 Stockage et distribution de documents et de kits de communication en multipoints pour les besoins des services départementaux",
"reasons": [
"Le code CPV 64121100 figure à la fois dans un marché public déjà attribué à cette entreprise et dans cet appel d’offres ouvert.",
"Le libellé de l’appel d’offres partage un vocabulaire métier avec les marchés déjà remportés : distribution."
],
"source_data": {
"matching_cpv": "64121100",
"matching_terms": [
"distribution"
],
"tender": {
"id": "26-80049",
"object": "2026A0222 Stockage et distribution de documents et de kits de communication en multipoints pour les besoins des services départementaux",
"publication_date": "2026-08-13",
"deadline": "2026-09-18T13:30:00+00:00",
"days_remaining": 15,
"buyer": "CD des A-M - Secrétariat Général",
"departments": [
"6"
],
"procedure_code": "OUVERT",
"procedure": "Procédure Ouverte",
"notice_type": "Avis de marché",
"market_types": [
"SERVICES"
],
"criteria": [],
"descriptors": [
{
"code": "65",
"label": "Colis"
},
{
"code": "347",
"label": "Transport"
}
],
"cpv_codes": [
"64121100"
],
"url": "https://www.boamp.fr/pages/avis/?q=idweb:26-80049",
"source": "boamp-datadila.opendatasoft.com:boamp",
"source_type": "SOURCE_PUBLIQUE"
}
},
"sources": [
"company/fr/public-contracts",
"procurement/fr/search"
]
},
{
"type": "PUBLIC_TENDER",
"score": 0.88,
"title": "Prestations d'impression et de distribution de magazines",
"reasons": [
"Le code CPV 64121100 figure à la fois dans un marché public déjà attribué à cette entreprise et dans cet appel d’offres ouvert.",
"Le libellé de l’appel d’offres partage un vocabulaire métier avec les marchés déjà remportés : distribution."
],
"source_data": {
"matching_cpv": "64121100",
"matching_terms": [
"distribution"
],
"tender": {
"id": "26-83412",
"object": "Prestations d'impression et de distribution de magazines",
"publication_date": "2026-08-27",
"deadline": "2026-09-28T10:00:00+00:00",
"days_remaining": 25,
"buyer": "Communauté d'agglomération Evreux Portes Normandie",
"departments": [
"27"
],
"procedure_code": "OUVERT",
"procedure": "Procédure Ouverte",
"notice_type": "Avis de marché",
"market_types": [
"SERVICES"
],
"criteria": [
"environnementaux"
],
"descriptors": [
{
"code": "160",
"label": "Impression"
},
{
"code": "274",
"label": "Prestations de services"
}
],
"cpv_codes": [
"64121100",
"79823000",
"79824000"
],
"url": "https://www.boamp.fr/pages/avis/?q=idweb:26-83412",
"source": "boamp-datadila.opendatasoft.com:boamp",
"source_type": "SOURCE_PUBLIQUE"
}
},
"sources": [
"company/fr/public-contracts",
"procurement/fr/search"
]
}
],
"coverage": [
{
"service": "profile",
"status": "ok"
},
{
"service": "aids",
"status": "ok"
},
{
"service": "public_contracts",
"status": "ok"
},
{
"service": "procurement_search:64100000",
"status": "ok"
},
{
"service": "procurement_search:64121100",
"status": "ok"
},
{
"service": "procurement_search:75200000",
"status": "ok"
}
],
"limitations": [
"Une aide PUBLIC_AID n’est proposée que lorsqu’un project est fourni et correspond à la taxonomie publique ; elle reste potentiellement pertinente, jamais une confirmation officielle d’éligibilité.",
"Les opportunités PUBLIC_TENDER sont volontairement conservatrices : elles exigent un code CPV commun et un vocabulaire métier partagé avec des marchés déjà attribués à l’entreprise.",
"Aucune certification n’est recommandée automatiquement sans règle métier suffisamment démontrable."
]
}Billing policy
0.020 $ / call · charged on valid result · errors not charged.
Input / Output schemas
Simplified endpoint contracts. The complete schema remains available in OpenAPI 3.1.
Input schema
identifierstringRequired · 9-digit SIREN or 14-digit SIRETprojectstringOptional · Optional project context used for public-aid and opportunity matchinglimitintegerOptional · Maximum number of ranked opportunities to returnView full JSON Schema
{
"type": "object",
"properties": {
"identifier": {
"type": "string",
"pattern": "^[0-9]{9}([0-9]{5})?$",
"description": "9-digit SIREN or 14-digit SIRET"
},
"project": {
"type": "string",
"minLength": 2,
"description": "Optional project context used for public-aid and opportunity matching"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 25,
"default": 10,
"description": "Maximum number of ranked opportunities to return"
}
},
"required": [
"identifier"
],
"additionalProperties": false
}Output schema
identifierstringRequiredidentifier_typestringRequiredexistsbooleanRequiredsirenstring | nullRequirednamestring | nullRequiredcompany_statusstring | nullRequiredprojectstring | nullRequiredtotal_candidatesintegerRequiredreturned_countintegerRequiredtruncatedbooleanRequiredopportunitiesarrayRequiredcoveragearrayRequiredlimitationsarrayRequiredView full JSON Schema
{
"type": "object",
"properties": {
"identifier": {
"type": "string"
},
"identifier_type": {
"type": "string",
"enum": [
"siren",
"siret"
]
},
"exists": {
"type": "boolean"
},
"siren": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"company_status": {
"type": [
"string",
"null"
]
},
"project": {
"type": [
"string",
"null"
]
},
"total_candidates": {
"type": "integer"
},
"returned_count": {
"type": "integer"
},
"truncated": {
"type": "boolean"
},
"opportunities": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"PUBLIC_AID",
"PUBLIC_TENDER"
]
},
"score": {
"type": "number",
"minimum": 0,
"maximum": 1
},
"title": {
"type": "string"
},
"reasons": {
"type": "array",
"items": {
"type": "string"
}
},
"source_data": {
"type": "object"
},
"sources": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"type",
"score",
"title",
"reasons",
"source_data",
"sources"
],
"additionalProperties": false
}
},
"coverage": {
"type": "array",
"items": {
"type": "object",
"properties": {
"service": {
"type": "string"
},
"status": {
"type": "string"
}
},
"required": [
"service",
"status"
],
"additionalProperties": false
}
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"identifier",
"identifier_type",
"exists",
"siren",
"name",
"company_status",
"project",
"total_candidates",
"returned_count",
"truncated",
"opportunities",
"coverage",
"limitations"
],
"additionalProperties": false
}Example queries
Queries published with the API to help select the right endpoint.
What public opportunities are actionable for SIREN 356000000?
Rank grants and open tenders for this company’s digital-transformation project.
Which open tenders resemble contracts this company has already won?