List an entity's key parties
curl --request GET \
--url https://partners-api.sandbox.securitize.io/investors/v1/onboarding-reliance/investors/{investorId}/key-parties \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://partners-api.sandbox.securitize.io/investors/v1/onboarding-reliance/investors/{investorId}/key-parties', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://partners-api.sandbox.securitize.io/investors/v1/onboarding-reliance/investors/{investorId}/key-parties"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"meta": {
"length": 3
},
"data": [
{
"keyPartyId": "6aca84eceb86373b87dca9e4",
"externalKeyPartyId": "holdco-test-0003",
"investorId": "6aca84e5dc49fe8369dd1da4",
"signerType": "entity",
"uboOwning": "none",
"details": {
"entityName": "Acme Holdings Test plc",
"entityType": "other",
"address": {
"street": "New Street",
"city": "London",
"countryCode": "GB",
"postalCode": "EC1A 1BB"
}
},
"documents": [
{
"id": "6aca84f0eb86373b87dca9f8",
"type": "shareholders-list-25-percent-ubo-control",
"uploadedAt": "2026-10-10T18:33:20.828Z"
}
],
"verification": {
"status": "complete",
"missing": []
}
},
{
"keyPartyId": "6aca84eadc49fe8369dd1db5",
"externalKeyPartyId": "sh-test-0002",
"investorId": "6aca84e5dc49fe8369dd1da4",
"signerType": "individual",
"uboOwning": "none",
"isBeneficialOwner": false,
"details": {
"firstName": "Test_Jane_Shareholder",
"lastName": "KYC_Sandbox",
"dateOfBirth": "1985-02-20T00:00:00.000Z",
"birthCountry": "US",
"address": {
"street": "Test Avenue",
"city": "Boston",
"state": "MA",
"countryCode": "US",
"postalCode": "02101"
}
},
"documents": [
{
"id": "6aca84eedc49fe8369dd1dc9",
"type": "passport",
"documentNumber": "P-UBO2-0000",
"expiresAt": "2031-05-15",
"uploadedAt": "2026-10-10T18:33:18.798Z",
"side": "front"
}
]
},
{
"keyPartyId": "6aca84e7dc49fe8369dd1dab",
"externalKeyPartyId": "ubo-test-0001",
"investorId": "6aca84e5dc49fe8369dd1da4",
"signerType": "individual",
"uboOwning": "25+",
"isBeneficialOwner": true,
"details": {
"firstName": "Test_Jane_UBO",
"lastName": "KYC_Sandbox-Corrected",
"middleName": "Ada",
"dateOfBirth": "1990-04-12T00:00:00.000Z",
"birthCountry": "US",
"address": {
"street": "Corrected Street",
"houseNumber": "2",
"city": "Boston",
"state": "MA",
"countryCode": "US",
"postalCode": "02101"
}
},
"documents": [
{
"id": "6aca84eceb86373b87dca9ef",
"type": "passport",
"documentNumber": "P-UBO1-0000",
"expiresAt": "2032-01-01",
"uploadedAt": "2026-10-10T18:33:16.567Z",
"side": "front"
}
]
}
]
}Key parties
List an entity's key parties
Returns every key party of the entity, both kinds, newest first, each with its documents. Company key parties also carry their verification checklist, so you can see which still owe documents before you submit. Person key parties carry no verification here; their readiness is reported by the document upload response.
Use it to check readiness before submitting, and to recover a lost keyPartyId by matching your externalKeyPartyId. No paging: an entity’s key parties are a bounded set.
An investorId that is unknown, belongs to another partner, or belongs to an individual answers 404 investor_not_found.
GET
/
investors
/
{investorId}
/
key-parties
List an entity's key parties
curl --request GET \
--url https://partners-api.sandbox.securitize.io/investors/v1/onboarding-reliance/investors/{investorId}/key-parties \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://partners-api.sandbox.securitize.io/investors/v1/onboarding-reliance/investors/{investorId}/key-parties', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://partners-api.sandbox.securitize.io/investors/v1/onboarding-reliance/investors/{investorId}/key-parties"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"meta": {
"length": 3
},
"data": [
{
"keyPartyId": "6aca84eceb86373b87dca9e4",
"externalKeyPartyId": "holdco-test-0003",
"investorId": "6aca84e5dc49fe8369dd1da4",
"signerType": "entity",
"uboOwning": "none",
"details": {
"entityName": "Acme Holdings Test plc",
"entityType": "other",
"address": {
"street": "New Street",
"city": "London",
"countryCode": "GB",
"postalCode": "EC1A 1BB"
}
},
"documents": [
{
"id": "6aca84f0eb86373b87dca9f8",
"type": "shareholders-list-25-percent-ubo-control",
"uploadedAt": "2026-10-10T18:33:20.828Z"
}
],
"verification": {
"status": "complete",
"missing": []
}
},
{
"keyPartyId": "6aca84eadc49fe8369dd1db5",
"externalKeyPartyId": "sh-test-0002",
"investorId": "6aca84e5dc49fe8369dd1da4",
"signerType": "individual",
"uboOwning": "none",
"isBeneficialOwner": false,
"details": {
"firstName": "Test_Jane_Shareholder",
"lastName": "KYC_Sandbox",
"dateOfBirth": "1985-02-20T00:00:00.000Z",
"birthCountry": "US",
"address": {
"street": "Test Avenue",
"city": "Boston",
"state": "MA",
"countryCode": "US",
"postalCode": "02101"
}
},
"documents": [
{
"id": "6aca84eedc49fe8369dd1dc9",
"type": "passport",
"documentNumber": "P-UBO2-0000",
"expiresAt": "2031-05-15",
"uploadedAt": "2026-10-10T18:33:18.798Z",
"side": "front"
}
]
},
{
"keyPartyId": "6aca84e7dc49fe8369dd1dab",
"externalKeyPartyId": "ubo-test-0001",
"investorId": "6aca84e5dc49fe8369dd1da4",
"signerType": "individual",
"uboOwning": "25+",
"isBeneficialOwner": true,
"details": {
"firstName": "Test_Jane_UBO",
"lastName": "KYC_Sandbox-Corrected",
"middleName": "Ada",
"dateOfBirth": "1990-04-12T00:00:00.000Z",
"birthCountry": "US",
"address": {
"street": "Corrected Street",
"houseNumber": "2",
"city": "Boston",
"state": "MA",
"countryCode": "US",
"postalCode": "02101"
}
},
"documents": [
{
"id": "6aca84eceb86373b87dca9ef",
"type": "passport",
"documentNumber": "P-UBO1-0000",
"expiresAt": "2032-01-01",
"uploadedAt": "2026-10-10T18:33:16.567Z",
"side": "front"
}
]
}
]
}Authorizations
OAuth 2.0 client credentials. Exchange the client id and secret Securitize issued you for a bearer token at the token URL (the host root, not under the base URL), with grant_type=client_credentials; the token lasts 2 hours and goes in the Authorization: Bearer header of every request. No scope is needed. The token identifies your partner account, so you never send a partner id, and every record you create is scoped to you.
Path Parameters
Response
Every key party on this entity, newest first.