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

Risk Assessment

2 of 4
POSThttps://api.milda.ai/v1/risk-assessment/financials

Company Financials

application/json
01

Description

Risk Assessment — Financials

POST /v1/risk-assessment/financials

Year-by-year financials for a selected candidate.

Request
  • candidate_id (required) — Candidate ID from candidates.
Response

One record per year, newest first. Each has year and that year's figures, e.g. currency, reported_date, turnover, ebitda, operating_profit, profit_after_tax, total_assets, total_liabilities, net_assets, employee_numbers and ratios such as net_margin. Every record has the same fields; a figure that was not reported is null.

Returns 204 No Content if no financials are available.

Credits

Charged a small flat fee (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
CompanyFinancials[]type0 fields

Financials as one record per reporting year, newest first. Each record has an integer `year` plus the financial metrics (snake_cased, e.g. turnover, net_margin). The set of metrics is consistent across years for a given company; values are null where not reported.

No documented fields.

PreviousRisk CandidatesNextCompany Ownership

© 2026 Milda.ai All rights reserved.

  • Privacy policy
  • Terms and Conditions
  • Blog