POST
https://api.milda.ai/v1/tender-awards/awardsTender Award List
application/json01
Description
Tender Awards — Award List
POST /v1/tender-awards/awards
The individual awards behind the overview, newest first, each linked to its notice.
Request
candidate_id(required) — fromcandidates.page_no(default 1) — page of results, 25 per page.
Response
rows— list of awards. Each row:award_date— YYYY-MM-DD.title— title of the notice.source—ted(EU),usaspending(US prime contract) orusaspending_subaward(US subcontract).roles— the company's role:sole,leaderormemberof a consortium (EU);primeorsubrecipient(US).place_countries— places of performance.value_eur— contract value in EUR; the buyer's estimate when an EU award states no amount.nullwhen neither is given.buyers— contracting authorities or agencies.url— link to the notice on TED or USAspending.total— total awards.
Returns 204 No Content if the candidate has no awards or the page is past the end.
Credits
Charged a small flat fee per page (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
AwardsRequestAwardsRequesttypereq2 fields
candidate_idstringyesCandidate ID returned by the candidates endpoint.
page_nointeger—Page number (25 awards per page).min 1 · default 1
04
Responses
200 Successful Response422 Validation Error
AwardsResponsetype2 fields
+rowsAward[]Awards for the requested page, newest first.
source"ted" | "usaspending" | "usaspending_subaward"`ted` = EU contract award notice; `usaspending` = US federal prime contract; `usaspending_subaward` = US federal subcontract.
award_datestring | nullAward date (YYYY-MM-DD).
titlestring | nullTitle of the contract notice.
roles"sole" | "leader" | "member" | "prime" | "subrecipient"[]The company's role: `sole` winner, consortium `leader` or `member` (EU); `prime` contractor or `subrecipient` (US).
place_countriesstring[]Places of performance, as ISO 3166-1 alpha-2 codes.
value_eurnumber | nullContract value in EUR. Null when the award states none.
buyersstring[]Contracting authorities or agencies.
urlstring | nullLink to the award notice.
totalintegerTotal number of awards.default 0