POST
https://api.milda.ai/v1/risk-assessment/candidatesCandidates
application/json01
Description
Risk Assessment — Candidates
POST /v1/risk-assessment/candidates
Step 1 of risk assessment. Resolves a company id to the candidate companies used for the data endpoints. 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 data endpoints below.
- registration_number, name, country_code, url, age, size
Returns 204 No Content if nothing matches.
Flow & credits
Pick a company_id and call any of the data endpoints:
financials, ownership, report. This candidates step is free.
02
Headers
nameinreqdescription
tokenheaderyesAPI token. Issued per account; check it with GET /v1/credit-usage.
03
Request body
CompanyRequestCompanyRequesttypereq1 fields
company_idstringyesCompany ID.
04
Responses
200 Successful Response422 Validation Error