POST
https://api.milda.ai/v1/risk-assessment/ownershipCompany Ownership
application/json01
Description
Risk Assessment — Ownership
POST /v1/risk-assessment/ownership
Shareholders and corporate ownership structure for a selected candidate.
Request
candidate_id(required) — Candidate ID from candidates.
Response
shareholders— list of{id, name, quantity, currency, share_value, created_at, share_type, share_price}ownership_structure— list of{nr, name, country_code, registration_number}(hierarchicalnr, e.g. "1.", "1.1")
Returns 204 No Content if no ownership data is 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
CandidateRequestCandidateRequesttypereq1 fields
candidate_idstringyesCandidate ID returned by the candidates endpoint.
04
Responses
200 Successful Response422 Validation Error
Ownershiptype2 fields
+shareholdersShareholderItem[]Direct shareholders of the company.
namestring | nullShareholder name.
idinteger | string | nullShareholder identifier.
share_typestring | nullType/class of shares.
quantitynumber | nullNumber of shares held.
share_valuestring | nullTotal value of the held shares.
share_pricenumber | nullPrice per share.
currencystring | nullCurrency of the share value/price.
created_atstring | nullDate the shareholding was recorded (YYYY-MM-DD).
+ownership_structureOwnershipStructureRow[]Hierarchical corporate ownership / group structure.
nrstring | nullHierarchical position in the ownership tree (e.g. '1.', '1.1').
namestring | nullEntity name.
country_codestring | nullTwo-letter ISO 3166-1 alpha-2 country code.
registration_numberstring | nullEntity registration number.