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

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

Tender Awards Overview

application/json
01

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) — from candidates.
Response
  • summary — n_contracts, total_value_eur and avg_value_eur for 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 into eu_* and us_*, 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

CandidateRequest
CandidateRequesttypereq1 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
PreviousTender Award CandidatesNextTender Award Buyers

© 2026 Milda.ai All rights reserved.

  • Privacy policy
  • Terms and Conditions
  • Blog