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

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

Tender Award Buyers

application/json
01

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) — from candidates.
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

CandidateRequest
CandidateRequesttypereq1 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
PreviousTender Awards OverviewNextTender Award Partners

© 2026 Milda.ai All rights reserved.

  • Privacy policy
  • Terms and Conditions
  • Blog