---
title: "Public-buyer risk profile (beta, ES + FR)"
method: GET
path: "/procurement/buyer/{id}"
tags: ["Procurement"]
---

# Public-buyer risk profile (beta, ES + FR)

`GET /procurement/buyer/{id}`

## Request

- Base URL: `https://api.prometiam.com/functions/v1/risk-api`
- URL: `https://api.prometiam.com/functions/v1/risk-api/procurement/buyer/{id}`
- Auth: HTTP bearer

The risk profile of a contracting body: two calibrated scores about the BUYER, its behaviour ratios, the awards a reviewer would open first and its five largest supplier relationships. **Never a score for a supplier or a tender.** `competition` = probability that the buyer's next award receives a single bid, against what comparable tenders attract; `counterparty` = probability that a supplier it awards to enters insolvency within 24 months (a weak signal: about twice the base rate at the top). Risk block per model: `score` (1-10, ladder on the log-odds of `probability`; 1 = 1st percentile of the country's scored buyers, 10 = 99th, anchors frozen), `probability` (the buyer's calibrated rate for the outcome on its next award: observed count shrunk toward the model expectation with a 30-award prior, calibrated out of time), `base_rate`, `relative_risk` (= probability / base_rate), `log_odds`, `percentile` (of the residual observed minus expected, the peer comparison), `observed_rate`, `expected_rate`, `excess`, `awards_scored`, `confidence` (high/medium/low by awards scored). A body is scored once it has at least 20 awards in the period. Beta; Spain and France; a score is a prompt to look, not a finding of wrongdoing.

## Path parameters

- `id` string, required

## Query parameters

- `country` 'ES' | 'FR'

## Response `200`

buyer, as_of, coverage (awards, contracts, distinct_suppliers, first/last award, awarded_value_eur, framework_ceilings_eur), risk {competition, counterparty}, behaviour (single_bid_rate, direct_award_rate, framework_rate, modification_rate, bids_disclosed_rate, top_supplier_value_share, supplier_hhi, average_bids), evidence[] (up to three awards), top_suppliers[] (five pairs), limits[]

## Other responses

- `400`: country other than ES or FR
- `404`: No scored buyer with that identifier in that country

---

[API](https://skmtc.dev/prometiam/apis/prometiam-risk-intelligence-api.md) · [All operations](https://skmtc.dev/prometiam/apis/prometiam-risk-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/prometiam/apis/prometiam-risk-intelligence-api/revisions/3ee0626d5a45?raw)