Get a list of individual or business account holders
Get a list of individual or business account holders and their KYC or KYB evaluation status.
Query parameters
If applicable, represents the external_id associated with the account_holder.
The number of account_holders to limit the response to.
(Individual Account Holders only) The first name of the account holder. The query is case insensitive and supports partial matches.
(Individual Account Holders only) The last name of the account holder. The query is case insensitive and supports partial matches.
(Business Account Holders only) The legal business name of the account holder. The query is case insensitive and supports partial matches.
Phone number of the account holder. The query must be an exact match.
Email address of the account holder. The query must be an exact match, case insensitive.
A cursor representing an item's token before which a page of results should end. Used to retrieve the previous page of results before this item.
A cursor representing an item's token after which a page of results should begin. Used to retrieve the next page of results after this item.
Date string in RFC 3339 format. Only entries created after the specified time will be included. UTC time zone.
Date string in RFC 3339 format. Only entries created before the specified time will be included. UTC time zone.
Response
OK
Example response
{
"data": [
{
"beneficial_owner_individuals": [
{
"address": {
"address1": "123 Old Forest Way",
"city": "Omaha",
"country": "USA",
"postal_code": "68022",
"state": "NE"
},
"dob": "1991-03-08 08:00:00",
"email": "tom@middle-earth.com",
"first_name": "Tom",
"last_name": "Bombadil",
"phone_number": "+15555555555"
}
],
"business_entity": {
"address": {
"address1": "123 Old Forest Way",
"city": "Omaha",
"country": "USA",
"postal_code": "68022",
"state": "NE"
},
"government_id": "114-123-1513",
"legal_business_name": "Acme, Inc.",
"phone_numbers": [
"+15555555555"
]
},
"control_person": {
"address": {
"address1": "123 Old Forest Way",
"city": "Omaha",
"country": "USA",
"postal_code": "68022",
"state": "NE"
},
"dob": "1991-03-08 08:00:00",
"email": "tom@middle-earth.com",
"first_name": "Tom",
"last_name": "Bombadil",
"phone_number": "+15555555555"
},
"email": "+15555555555",
"individual": {
"address": {
"address1": "123 Old Forest Way",
"city": "Omaha",
"country": "USA",
"postal_code": "68022",
"state": "NE"
},
"dob": "1991-03-08 08:00:00",
"email": "tom@middle-earth.com",
"first_name": "Tom",
"last_name": "Bombadil",
"phone_number": "+15555555555"
},
"phone_number": "+15555555555"
}
]
}