# Profile of a public buyer

The most useful field in this route is the average number of bids received: it measures competitive intensity at that buyer. A buyer who systematically receives a single bid is not approached like one who receives eight.

## What the route returns

Catalogue description, exactly as agents read it:

**Procurement profile of a French public buyer (SIRET): contract counts and amounts, activity by year, top CPV segments, incumbent suppliers ranked with their contracts expiring within 18 months, framework-agreement share, average bids received per tender (competitive intensity) and median data-publication delay — the buying habits a bidder wants before a sourcing meeting. From DECP open data.**

## Expected identifier

The buyer's 14-digit establishment identifier.

> ⚠️ A wrongly formatted identifier returns `400` and is **not billed** — but it costs you a round trip. It is the leading cause of failed calls on the foreign routes.

## Extract from a genuinely paid response

Dated snapshot from 2026-08-18, truncated to one item per array. It is not live data. The full extract is served **free of charge** from [the samples surface](https://api.sirenic.eu/exemples/), and the schema from the OpenAPI document.

```
{
 "acheteur": {
  "siret": "26310012500016",
  "siren": "263100125",
  "nom": "CENTRE HOSPITALIER UNIVERSITAIRE DE TOULOUSE"
 },
 "nombre_marches": 5649,
 "montant_moyen": 2039605,
 "marches_en_cours": 4768,
 "echeances_12_mois": 1163,
 "prochaine_echeance": "2026-08-22",
 "habitudes": {
  "part_accords_cadres_pct": 78.3,
  "offres_recues_moyenne": 3.5,
  "delai_publication_median_jours": 11
 },
 "top_cpv": [
  {
   "cpv4": "3300",
   "nombre": 2989
  }
 ],
 "titulaires_principaux": [
  {
   "siren": "433944485",
   "nom": "ARROW GENERIQUES",
   "nombre_marches": 162,
   "marches_expirant_18_mois": 65
  }
 ]
}
```

## Price and billing

Price: **$0.02**. The authoritative amount is the one in the `402` quote returned by the route itself — not this text, which derives from the same grid but is still just a page.

An error response **cancels the payment**: a `400`, `404` or `503` is never billed. An upstream outage closes the route with a `503` rather than serving a degraded response.

## Calling the route

```
# 1. Le devis, sans rien payer : la route répond 402 avec son montant
curl -i https://api.sirenic.eu/v1/acheteur/{siret}/profil

# 2. L'appel réglé — le client x402 paie le devis et rejoue la requête
npx x402-fetch https://api.sirenic.eu/v1/acheteur/{siret}/profil

# 3. Ou en MCP, dans Claude Code / Cursor / un agent
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp
```

## Neighbouring routes

- `/v1/marches/expirations` — $0.05
- `/v1/entreprise/{siren}/marches-publics` — $0.01

## How you pay

Every route is paid **per call**, in USDC or EURC on the Base network, over the x402 protocol: no account to create, no API key, no subscription. The first call returns a `402` quote your client settles, then replays the call. A failed call is never billed.

Would you rather have a euro invoice and prepaid credits? That is **in preparation**, and we will not announce a date until it is open. Write to [contact@sirenic.eu](mailto:contact@sirenic.eu?subject=Euro%20credit%20packs) and we will let you know when it opens.

Paid responses are **Ed25519-signed**: you can later prove what was served to you, and when. The whole catalogue is free to read in the [OpenAPI document](https://api.sirenic.eu/openapi.json) and in [llms.txt](https://api.sirenic.eu/llms.txt).

**One call, end to end**

```
# Client x402 (npm) — le devis 402 est réglé et l'appel rejoué automatiquement
npx x402-fetch https://api.sirenic.eu/v1/entreprise/552032534

# Ou en MCP, dans Claude Code / Cursor
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp
```

## Routes used and pricing

| Route | Price | What it returns |
| --- | --- | --- |
| `/v1/acheteur/{siret}/profil` | $0.02 | Procurement profile of a French public buyer (SIRET): contract counts and amounts, activity by year, top CPV segments, incumbent suppliers ranked with their contracts expiring within 18 months, framework-agreement share, average bids received per tender (competitive intensity) and median data-publication delay — the buying habits a bidder wants before a sourcing meeting. From DECP open data. |

> ⚠️ Contract end dates are estimates, computed from the notification date and the declared duration. This is not an official re-tendering calendar.

## Take it further

- [See a real response (free)](https://api.sirenic.eu/exemples/acheteur-siret-profil.json)
- [Get the quote for /v1/acheteur/{siret}/profil](https://api.sirenic.eu/v1/acheteur/{siret}/profil)
- [Get notified about euro packs](mailto:contact@sirenic.eu?subject=Euro%20credit%20packs)

## Read next

- [Anticipating public-contract expiries](https://api.sirenic.eu/en/use-cases/anticipate-public-contract-expiries-before-notice)

---

Volume figures on this page were measured in our database on 2026-08-19. They are dated snapshots, not live counters.

Full catalogue : https://api.sirenic.eu/