helpmyagent.com
FR Connect my AI
☰

French Public Contract Awards

Searches awarded French public contracts using DECP filters for CPV, location, buyer, holder, dates and amounts.

0.010 USD

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

When to use this API?

Use for

  • Search French public contracts that have already been awarded using CPV, location, buyer, holder, date or amount filters.

Avoid when

  • Use procurement/fr/search for currently open BOAMP tenders.
  • Use company/fr/public-contracts when you only need contracts awarded to one known French company.

Limitations

  • Coverage follows the published DECP dataset and source fields.

Sources and provenance

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
cpv_prefixstring

departmentstring

buyerstring

holderstring

date_fromstring

date_tostring

min_amountnumber

max_amountnumber

limitinteger

View full JSON Schema
{
    "type": "object",
    "properties": {
        "cpv_prefix": {
            "type": "string",
            "pattern": "^[0-9]{1,8}$"
        },
        "department": {
            "type": "string",
            "pattern": "^(?:[0-9]{2,3}|2A|2B)$"
        },
        "buyer": {
            "type": "string",
            "minLength": 2,
            "maxLength": 200
        },
        "holder": {
            "type": "string",
            "pattern": "^[0-9]{9}([0-9]{5})?$"
        },
        "date_from": {
            "type": "string",
            "format": "date"
        },
        "date_to": {
            "type": "string",
            "format": "date"
        },
        "min_amount": {
            "type": "number",
            "minimum": 0
        },
        "max_amount": {
            "type": "number",
            "minimum": 0
        },
        "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 50,
            "default": 20
        }
    },
    "additionalProperties": false
}
Output schema
filtersobject

Required

source_statusstring

Required

total_countinteger | null

Required

returned_countinteger | null

Required

truncatedboolean | null

Required

awardsarray

Required

generated_atstring

Required

limitationsarray

View full JSON Schema
{
    "type": "object",
    "properties": {
        "filters": {
            "type": "object",
            "properties": {
                "cpv_prefix": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "department": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "buyer": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "holder": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "date_from": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "date_to": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "min_amount": {
                    "type": [
                        "number",
                        "integer",
                        "null"
                    ]
                },
                "max_amount": {
                    "type": [
                        "number",
                        "integer",
                        "null"
                    ]
                }
            },
            "required": [
                "cpv_prefix",
                "department",
                "buyer",
                "holder",
                "date_from",
                "date_to",
                "min_amount",
                "max_amount"
            ],
            "additionalProperties": false
        },
        "source_status": {
            "type": "string",
            "enum": [
                "ok",
                "unavailable"
            ]
        },
        "total_count": {
            "type": [
                "integer",
                "null"
            ]
        },
        "returned_count": {
            "type": [
                "integer",
                "null"
            ]
        },
        "truncated": {
            "type": [
                "boolean",
                "null"
            ]
        },
        "awards": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "contract_id": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "object": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "nature": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "procedure": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "cpv": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "amount": {
                        "type": [
                            "number",
                            "integer",
                            "null"
                        ]
                    },
                    "duration_months": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "notification_date": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "publication_date": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "buyer_siret": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "buyer_name": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "holder_sirets": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "execution_location_code": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "execution_location_type": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "execution_location_name": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "required": [
                    "contract_id",
                    "object",
                    "nature",
                    "procedure",
                    "cpv",
                    "amount",
                    "duration_months",
                    "notification_date",
                    "publication_date",
                    "buyer_siret",
                    "buyer_name",
                    "holder_sirets",
                    "execution_location_code",
                    "execution_location_type",
                    "execution_location_name"
                ],
                "additionalProperties": false
            }
        },
        "generated_at": {
            "type": "string"
        },
        "limitations": {
            "type": "array",
            "items": {
                "type": "string"
            }
        }
    },
    "required": [
        "filters",
        "source_status",
        "total_count",
        "returned_count",
        "truncated",
        "awards",
        "generated_at"
    ],
    "additionalProperties": false
}

Example queries

Find awarded French public contracts for CPV 641 in the last year.