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

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

Tender Award Candidates

application/json
01

Description

Tender Awards — Candidates

POST /v1/tender-awards/candidates

Step 1 of tender awards. Tender awards are linked to registered legal entities, so a company ID first resolves to its candidates: the registered companies behind it, such as a parent and its national subsidiaries. If you already pass the exact target company ID, a single matching candidate is returned.

Request
  • company_id (required) — Company ID.
Response

List of candidates: - candidate_id — pass this to the endpoints below. - registration_number, name, country_code, url, age, size

Candidate IDs are the same as in risk assessment, so a candidate_id from either group works in both.

Returns 204 No Content if nothing matches.

Flow & credits

Pick a candidate_id and call overview, buyers, partners or awards. A candidate with no awards returns 204 No Content there, at no cost, so try the next one. This candidates step is free.

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

CompanyRequest
CompanyRequesttypereq1 fields
company_idstringyesCompany ID.
04

Responses

200 Successful Response422 Validation Error

Returns a JSON array. Each item:

TenderCandidatetype7 fields
candidate_idstringCandidate ID. Pass this to the other tender award endpoints.
namestring | nullCompany name.
registration_numberstring | nullOfficial company registration number.
country_codestring | nullTwo-letter ISO 3166-1 alpha-2 country code.
urlstring | nullCompany website URL.
agestring | nullCompany age category.
sizestring | nullCompany size category by employee count.
PreviousRisk ReportNextTender Awards Overview

© 2026 Milda.ai All rights reserved.

  • Privacy policy
  • Terms and Conditions
  • Blog