POST
https://api.milda.ai/v1/tender-awards/overviewTender Awards Overview
application/json01
Description
Tender Awards — Overview
POST /v1/tender-awards/overview
Public contracts a company won, with the main breakdowns. Covers EU contract award notices from TED and US federal contracts from USAspending, awarded from 2025 onwards. Use it to size a company's public-sector business and see where and in which categories it wins.
Request
candidate_id(required) — fromcandidates.
Response
summary—n_contracts,total_value_eurandavg_value_eurfor each source:eu— contracts won in the EU (TED).us— US federal prime contracts.us_subawards— US federal subcontracts. Reported on their own and not counted as contracts won.by_country— contracts won by place of performance.eu_by_cpv— EU contracts by CPV division (first two digits of the CPV code), with its name.us_by_psc— US contracts by Product and Service Code, with its name.by_quarter— contracts and value per quarter, split intoeu_*andus_*, oldest first.
All values are in EUR. When an EU award states no awarded amount, the buyer's estimated value is used instead. For framework agreements that estimate is often the ceiling. avg_value_eur averages only the contracts that state a value.
Returns 204 No Content if the candidate has no awards.
Credits
Charged a small flat fee per request (data credits).
02
Headers
nameinreqdescription
tokenheaderone ofYour API token, sent as "token: YOUR_API_TOKEN". Send this or Authorization.
Authorizationheaderone ofThe same token in the standard form, sent as "Authorization: Bearer YOUR_API_TOKEN" (the word Bearer, a space, then your token). Send this or token.
03
Request body
CandidateRequestCandidateRequesttypereq1 fields
candidate_idstringyesCandidate ID returned by the candidates endpoint.
04
Responses
200 Successful Response422 Validation Error
TenderOverviewtype5 fields
+summaryContractSummaryContracts won, total and average value, per source.
+euContractTotalsContracts won in the EU (TED).
n_contractsintegerNumber of contracts.default 0
total_value_eurnumberCombined value of the contracts, in EUR.default 0
avg_value_eurnumber | nullAverage value of the contracts that state a value, in EUR. Null when none do.
+usContractTotalsUS federal prime contracts won (USAspending).
n_contractsintegerNumber of contracts.default 0
total_value_eurnumberCombined value of the contracts, in EUR.default 0
avg_value_eurnumber | nullAverage value of the contracts that state a value, in EUR. Null when none do.
+us_subawardsContractTotalsUS federal subcontracts. Reported on their own and not counted as contracts won.
n_contractsintegerNumber of contracts.default 0
total_value_eurnumberCombined value of the contracts, in EUR.default 0
avg_value_eurnumber | nullAverage value of the contracts that state a value, in EUR. Null when none do.
+by_countryCountryContracts[]Contracts won by place of performance, most contracts first.
countrystring | nullTwo-letter ISO 3166-1 alpha-2 code of the place of performance.
n_contractsintegerContracts performed in this country.default 0
total_value_eurnumberCombined value of those contracts, in EUR.default 0
+eu_by_cpvCategoryContracts[]EU contracts by CPV division (the first two digits of the CPV code), most contracts first.
codestring | nullCategory code.
namestring | nullCategory name.
n_contractsintegerContracts in this category.default 0
total_value_eurnumberCombined value of those contracts, in EUR.default 0
+us_by_pscCategoryContracts[]US contracts by Product and Service Code (PSC), most contracts first.
codestring | nullCategory code.
namestring | nullCategory name.
n_contractsintegerContracts in this category.default 0
total_value_eurnumberCombined value of those contracts, in EUR.default 0
+by_quarterQuarterContracts[]Contracts won per quarter, oldest first. Quarters with no awards are left out.
quarterstringCalendar quarter of the award date.
eu_n_contractsintegerEU contracts awarded in the quarter.default 0
eu_value_eurnumberValue of those EU contracts, in EUR.default 0
us_n_contractsintegerUS federal prime contracts awarded in the quarter.default 0
us_value_eurnumberValue of those US contracts, in EUR.default 0