POST
https://api.milda.ai/v1/risk-assessment/reportReport
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
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
RiskReporttypereq2 fields
+risk_assessment_reportRiskAssessmentReport | null—The generated risk assessment report.
company_idstring | null—Candidate ID the report was generated for.
company_namestring | null—Company name.
countrystring | null—Company country.
geopolitical_exposurestring | null—Analysis of geopolitical exposure (e.g. ties to high-risk jurisdictions).
geopolitical_exposure_overall_riskstring | null—Overall geopolitical exposure risk: 'low', 'medium', or 'high'.
sanctions_and_legalstring | null—Analysis of sanctions listings and legal/litigation exposure.
sanctions_and_legal_overall_riskstring | null—Overall sanctions & legal risk: 'low', 'medium', or 'high'.
financial_healthstring | null—Analysis of solvency, liquidity and revenue trends.
financial_health_overall_riskstring | null—Overall financial health risk: 'low', 'medium', or 'high'.
regulatory_ethicsstring | null—Analysis of regulatory and ethics concerns.
regulatory_ethics_overall_riskstring | null—Overall regulatory & ethics risk: 'low', 'medium', or 'high'.
data_privacy_cyberstring | null—Analysis of data privacy and cybersecurity incidents (e.g. GDPR fines, breaches).
data_privacy_cyber_overall_riskstring | null—Overall data privacy & cyber risk: 'low', 'medium', or 'high'.
ownership_governancestring | null—Analysis of ownership and governance risks (e.g. parent-company exposure).
ownership_governance_overall_riskstring | null—Overall ownership & governance risk: 'low', 'medium', or 'high'.
+company_detailsCompanyDetails | null—Company registration details, returned alongside the report.
registration_numberstring | null—Official company registration number.
statusstring | null—Registration status of the company.
date_of_incorporationstring | null—Date the company was incorporated (YYYY-MM-DD).
national_legal_formstring | null—National legal form of the company.
link_to_national_registerstring | null—Link to the company's entry in its national business register.