POST
https://api.milda.ai/v1/tender-awards/buyersTender Award Buyers
application/json01
Description
Tender Awards — Buyers
POST /v1/tender-awards/buyers
The public bodies that award the company contracts. Use it to find a company's main customers in the public sector.
Request
candidate_id(required) — fromcandidates.
Response
eu— EU contracting authorities (TED).us— US federal agencies (prime contracts only).
Each holds two rankings of up to 10 buyers, by_count (number of contracts) and by_value (total contract value). Each buyer:
- name, country
- n_contracts — contracts this buyer awarded to the company.
- total_value_eur — their combined value, in EUR.
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
TenderBuyerstype2 fields
+euBuyerRankingEU contracting authorities (TED).
+by_countBuyer[]Top 10 buyers by number of contracts.
namestring | nullBuyer name.
countrystring | nullTwo-letter ISO 3166-1 alpha-2 country code.
n_contractsintegerContracts this buyer awarded to the company.default 0
total_value_eurnumberCombined value of those contracts, in EUR.default 0
+by_valueBuyer[]Top 10 buyers by total contract value.
namestring | nullBuyer name.
countrystring | nullTwo-letter ISO 3166-1 alpha-2 country code.
n_contractsintegerContracts this buyer awarded to the company.default 0
total_value_eurnumberCombined value of those contracts, in EUR.default 0
+usBuyerRankingUS federal agencies (USAspending prime contracts).
+by_countBuyer[]Top 10 buyers by number of contracts.
namestring | nullBuyer name.
countrystring | nullTwo-letter ISO 3166-1 alpha-2 country code.
n_contractsintegerContracts this buyer awarded to the company.default 0
total_value_eurnumberCombined value of those contracts, in EUR.default 0
+by_valueBuyer[]Top 10 buyers by total contract value.
namestring | nullBuyer name.
countrystring | nullTwo-letter ISO 3166-1 alpha-2 country code.
n_contractsintegerContracts this buyer awarded to the company.default 0
total_value_eurnumberCombined value of those contracts, in EUR.default 0