POST
https://api.milda.ai/v1/risk-assessment/financialsFinancials
application/json01
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
List of rows, each with:
- metric — e.g. Turnover, EBITDA, Total-Assets, Employee-Numbers, …
- one value per year key (e.g. "2023", "2022")
Returns 204 No Content if no financials are available.
Credits
Charged a small flat fee (data credits).
02
Headers
nameinreqdescription
tokenheaderyesAPI token. Issued per account; check it with GET /v1/credit-usage.
03
Request body
CandidateRequestCandidateRequesttypereq1 fields
candidate_idstringyesCandidate ID returned by the candidates endpoint.
04
Responses
200 Successful Response422 Validation Error
CompanyFinancials[]typereq0 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.