Our dataPricingContact
Log in

API reference

Milda API

Base URL
https://api.milda.ai
Overview

Credit Usage1

  • GETCredit Usage

Company Search3

  • POSTFind Company
  • POSTText Search
  • POSTText Search Insights

Companies7

  • POSTSubmit Companies for Enrichment
  • POSTCompany Statuses
  • POSTCompany Profiles
  • POSTCompany Events
  • POSTPlaces of Performance
  • POSTGrowth Signals
  • POSTProducts & Clients

People2

  • POSTPeople Search
  • POSTVerified Email

Trade Data5

  • POSTTrade Candidates
  • POSTTrade Analytics
  • POSTShipping Records
  • POSTShipment Suppliers
  • POSTShipment Recipients

Patents7

  • POSTPatent Summary
  • POSTPatent Co-applicants
  • POSTPatent Inventors
  • POSTTechnology Users
  • POSTTechnology Providers
  • POSTPatent Citations
  • POSTPatent List

Publications5

  • POSTPublication Analytics
  • POSTPublication Authors
  • POSTPublication Funders
  • POSTCollaborating Organizations
  • POSTTop Cited Works

Risk Assessment4

  • POSTRisk Candidates
  • POSTCompany Financials
  • POSTCompany Ownership
  • POSTRisk Report

Tender Awards5

  • POSTTender Award Candidates
  • POSTTender Awards Overview
  • POSTTender Award Buyers
  • POSTTender Award Partners
  • POSTTender Award List

Tender Awards

5 of 5
POSThttps://api.milda.ai/v1/tender-awards/awards

Tender Award List

application/json
01

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) — from candidates.
  • 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) or usaspending_subaward (US subcontract).
  • roles — the company's role: sole, leader or member of a consortium (EU); prime or subrecipient (US).
  • place_countries — places of performance.
  • value_eur — contract value in EUR; the buyer's estimate when an EU award states no amount. null when 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

AwardsRequest
AwardsRequesttypereq2 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
PreviousTender Award Partners

© 2026 Milda.ai All rights reserved.

  • Privacy policy
  • Terms and Conditions
  • Blog