Get the submitted KYB entity data for a corporate
GET
/corporates/{corporateId}/kyb/entity Returns the company details and ownership graph submitted to pre-populate the KYB of the corporate
identified by the corporateId path parameter, so you can check what was recorded.
Alongside what you submitted, the response carries the corporate's own companyName,
registrationNumber, and registrationCountry, taken from the corporate record.
See Submit known KYB entity data for a corporate for how the graph is put together.
Request
Available on
SandboxProduction
Path parameters
Responses
200OK
Success
Headers
Body
application/json
CorporateKybEntityResponseSchemaCorporateKybEntityResponseSchema · object · 7 fields
Response example
{ "company": { "registrationDate": "2015-06-15", "legalForm": "H0PO", "classifications": [ { "type": "NACE", "code": "62.01", "description": "Computer programming activities" } ], "taxIdentifiers": [ { "identifier": "1234567890", "country": "GB" } ], "addresses": [ { "streetAddress": "1 High Street", "streetAddress2": "Flat 2", "postalCode": "W1A 1AA", "city": "London", "state": "Greater London", "region": "England", "country": "GB" } ], "websiteUrl": "https://www.acme.example" }, "companies": [ { "ref": "company-1", "details": { "name": "Acme Ltd", "registrationNumber": "12345678", "country": "GB", "registrationDate": "2015-06-15", "legalForm": "H0PO", "taxIdentifiers": [ { "identifier": "1234567890", "country": "GB" } ], "addresses": [ { "streetAddress": "1 High Street", "streetAddress2": "Flat 2", "postalCode": "W1A 1AA", "city": "London", "state": "Greater London", "region": "England", "country": "GB" } ] } } ], "individuals": [ { "ref": "person-1", "details": { "firstName": "Alex", "lastName": "Smith", "middleName": "Jordan", "maidenName": "Taylor", "birthDate": "1990-01-01", "birthCountry": "GB", "birthPlace": "London", "gender": "MALE", "nationalities": [ "string" ], "email": "[email protected]", "phoneNumber": "+447700900123", "taxIdentifiers": [ { "identifier": "1234567890", "country": "GB" } ], "addresses": [ { "streetAddress": "1 High Street", "streetAddress2": "Flat 2", "postalCode": "W1A 1AA", "city": "London", "state": "Greater London", "region": "England", "country": "GB" } ] }, "isBeneficialOwner": true, "isControllingPerson": true, "isBusinessContact": false, "isSignatory": true, "isDelegator": false } ], "relations": [ { "fromRef": "person-1", "toRef": "company-1", "roles": [ "SHAREHOLDER" ], "ownershipPercentage": 51.5, "votingRightsPercentage": 51.5, "position": "Director" } ], "companyName": "Acme Ltd", "registrationNumber": "12345678", "registrationCountry": "GB"}