POST
https://api.milda.ai/v1/risk-assessment/reportRisk Report
application/json01
Description
Risk Assessment — Risk Report
POST /v1/risk-assessment/report
The risk assessment report for a selected candidate, returned together with the company's registration details.
Request
candidate_id(required) — Candidate ID from candidates.
Response
risk_assessment_report— per-category analysis text + overall risk (low/medium/high) for: geopolitical exposure, sanctions & legal, financial health, regulatory & ethics, data privacy & cyber, ownership & governancecompany_details—registration_number,status,date_of_incorporation,national_legal_form,link_to_national_register
Returns 204 No Content if no report is available.
Credits
Charged a flat fee per report (data credits). It is the highest fee of the risk endpoints.
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
CandidateRequestCandidateRequesttypereq1 fields
candidate_idstringyesCandidate ID returned by the candidates endpoint.
04
Responses
200 Successful Response422 Validation Error
RiskReporttype2 fields
+risk_assessment_reportRiskAssessmentReport | nullThe generated risk assessment report.
Company
company_idstring | nullCandidate ID the report was generated for.
company_namestring | nullCompany name.
countrystring | nullCompany country.
Geopolitical exposure
geopolitical_exposure_overall_riskstring | nullOverall geopolitical exposure risk: 'low', 'medium', or 'high'.
geopolitical_exposurestring | nullAnalysis of geopolitical exposure (e.g. ties to high-risk jurisdictions).
Sanctions and legal
sanctions_and_legal_overall_riskstring | nullOverall sanctions & legal risk: 'low', 'medium', or 'high'.
sanctions_and_legalstring | nullAnalysis of sanctions listings and legal/litigation exposure.
Financial health
financial_health_overall_riskstring | nullOverall financial health risk: 'low', 'medium', or 'high'.
financial_healthstring | nullAnalysis of solvency, liquidity and revenue trends.
Regulatory and ethics
regulatory_ethics_overall_riskstring | nullOverall regulatory & ethics risk: 'low', 'medium', or 'high'.
regulatory_ethicsstring | nullAnalysis of regulatory and ethics concerns.
Data privacy and cyber
data_privacy_cyber_overall_riskstring | nullOverall data privacy & cyber risk: 'low', 'medium', or 'high'.
data_privacy_cyberstring | nullAnalysis of data privacy and cybersecurity incidents (e.g. GDPR fines, breaches).
Ownership and governance
ownership_governance_overall_riskstring | nullOverall ownership & governance risk: 'low', 'medium', or 'high'.
ownership_governancestring | nullAnalysis of ownership and governance risks (e.g. parent-company exposure).
+company_detailsCompanyDetails | nullCompany registration details, returned alongside the report.
registration_numberstring | nullOfficial company registration number.
statusstring | nullRegistration status of the company.
date_of_incorporationstring | nullDate the company was incorporated (YYYY-MM-DD).
national_legal_formstring | nullNational legal form of the company.
link_to_national_registerstring | nullLink to the company's entry in its national business register.