POST
https://api.milda.ai/v1/risk-assessment/ownershipOwnership
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
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
Ownershiptypereq2 fields
+shareholdersShareholderItem[]—Direct shareholders of the company.
idinteger | string | null—Shareholder identifier.
namestring | null—Shareholder name.
quantitynumber | null—Number of shares held.
currencystring | null—Currency of the share value/price.
share_valuestring | null—Total value of the held shares.
created_atstring | null—Date the shareholding was recorded (YYYY-MM-DD).
share_typestring | null—Type/class of shares.
share_pricenumber | null—Price per share.
+ownership_structureOwnershipStructureRow[]—Hierarchical corporate ownership / group structure.
nrstring | null—Hierarchical position in the ownership tree (e.g. '1.', '1.1').
namestring | null—Entity name.
country_codestring | null—Two-letter ISO 3166-1 alpha-2 country code.
registration_numberstring | null—Entity registration number.