helpmyagent.com
FR Connect my AI
☰

French Company Public Contracts

Returns public contracts awarded to a French company from consolidated French public procurement award data.

0.010 USD

Charged on valid result · Empty result not charged · Errors not charged

When to use this API?

Use for

  • You need public contracts already awarded to a French company.
  • You need historical procurement awards, buyers, amounts, CPV codes or execution-location data linked to a company identifier.

Avoid when

  • You need currently open tenders that a company could bid on; use procurement/fr/search or company/fr/opportunities.
  • You need private-sector contracts or non-public commercial relationships.

Limitations

  • Coverage depends on the consolidated DECP public award dataset and the holder identifiers available in it.
  • Returned totals and summaries describe the matched public records, not all commercial revenue of the company.

Sources and provenance

API Recherche d'entreprises

recherche-entreprises.api.gouv.fr

Données essentielles de la commande publique (DECP)

www.data.economie.gouv.fr

Input / Output schemas

Simplified endpoint contracts. The complete schema remains available in OpenAPI 3.1.

OpenAPI 3.1 →

Input schema
identifierstring

Required · 9-digit SIREN or 14-digit SIRET

limitinteger

Maximum number of awarded public contracts to return

View full JSON Schema
{
    "type": "object",
    "properties": {
        "identifier": {
            "type": "string",
            "pattern": "^[0-9]{9}([0-9]{5})?$",
            "description": "9-digit SIREN or 14-digit SIRET"
        },
        "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 50,
            "default": 20,
            "description": "Maximum number of awarded public contracts to return"
        }
    },
    "required": [
        "identifier"
    ],
    "additionalProperties": false
}
Output schema
identifierstring

Required

identifier_typestring

Required

existsboolean

Required

sirenstring | null

Required

namestring | null

Required

total_countinteger

Required

returned_countinteger

Required

truncatedboolean

Required

summaryobject

Required

contractsarray

Required

View 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"
            ]
        },
        "total_count": {
            "type": "integer"
        },
        "returned_count": {
            "type": "integer"
        },
        "truncated": {
            "type": "boolean"
        },
        "summary": {
            "type": "object",
            "properties": {
                "returned_amount": {
                    "type": [
                        "number",
                        "null"
                    ]
                },
                "latest_notification_date": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "top_buyers_in_response": {
                    "type": "array",
                    "items": {
                        "type": "object",
                        "properties": {
                            "siret": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "name": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "contracts_count": {
                                "type": "integer"
                            }
                        }
                    }
                }
            }
        },
        "contracts": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "object": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "nature": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "procedure": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "cpv": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "amount": {
                        "type": [
                            "number",
                            "null"
                        ]
                    },
                    "duration_months": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "notification_date": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "publication_date": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "price_form": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "buyer": {
                        "type": "object",
                        "properties": {
                            "siret": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "name": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            }
                        }
                    },
                    "execution_location": {
                        "type": "object",
                        "properties": {
                            "code": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "code_type": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "name": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            }
                        }
                    },
                    "holder_sirets": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "social_considerations": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "environmental_considerations": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "innovative": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "modified": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "modification_object": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "modification_amount": {
                        "type": [
                            "number",
                            "null"
                        ]
                    },
                    "source": {
                        "type": "string"
                    },
                    "source_type": {
                        "type": "string",
                        "enum": [
                            "SOURCE_PUBLIQUE"
                        ]
                    }
                }
            }
        }
    },
    "required": [
        "identifier",
        "identifier_type",
        "exists",
        "siren",
        "name",
        "total_count",
        "returned_count",
        "truncated",
        "summary",
        "contracts"
    ],
    "additionalProperties": false
}

Example queries

Which public contracts were awarded to SIREN 356000000?
Who are this company’s public-sector buyers?
Show the latest public procurement awards for this company.