List
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
Date string in RFC 3339 format. Only entries created after the specified time will be included. UTC time zone.
Email address of the account holder. The query must be an exact match, case insensitive.
Date string in RFC 3339 format. Only entries created before the specified time will be included. UTC time zone.
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.
If applicable, represents the external_id associated with the account_holder.
(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.
The number of account_holders to limit the response to.
Phone number of the account holder. The query must be an exact match.
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.
Returns
Whether there are more accounts to be retrieved.
curl https://api.lithic.com/v1/account_holders \
-H "Authorization: $LITHIC_API_KEY"{
"data": [
{
"token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"created": "2019-12-27T18:11:19.117Z",
"account_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"beneficial_owner_entities": [
{
"address": {
"address1": "123 Old Forest Way",
"city": "Omaha",
"country": "USA",
"postal_code": "68022",
"state": "NE",
"address2": "address2"
},
"dba_business_name": "dba_business_name",
"entity_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"government_id": "114-123-1513",
"legal_business_name": "Acme, Inc.",
"phone_numbers": [
"+15555555555"
],
"parent_company": "parent_company"
}
],
"beneficial_owner_individuals": [
{
"address": {
"address1": "123 Old Forest Way",
"city": "Omaha",
"country": "USA",
"postal_code": "68022",
"state": "NE",
"address2": "address2"
},
"dob": "1991-03-08 08:00:00",
"email": "tom@middle-earth.com",
"entity_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"first_name": "Tom",
"last_name": "Bombadil",
"phone_number": "+15555555555"
}
],
"business_account_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"business_entity": {
"address": {
"address1": "123 Old Forest Way",
"city": "Omaha",
"country": "USA",
"postal_code": "68022",
"state": "NE",
"address2": "address2"
},
"dba_business_name": "dba_business_name",
"entity_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"government_id": "114-123-1513",
"legal_business_name": "Acme, Inc.",
"phone_numbers": [
"+15555555555"
],
"parent_company": "parent_company"
},
"control_person": {
"address": {
"address1": "123 Old Forest Way",
"city": "Omaha",
"country": "USA",
"postal_code": "68022",
"state": "NE",
"address2": "address2"
},
"dob": "1991-03-08 08:00:00",
"email": "tom@middle-earth.com",
"entity_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"first_name": "Tom",
"last_name": "Bombadil",
"phone_number": "+15555555555"
},
"email": "+15555555555",
"exemption_type": "AUTHORIZED_USER",
"external_id": "external_id",
"individual": {
"address": {
"address1": "123 Old Forest Way",
"city": "Omaha",
"country": "USA",
"postal_code": "68022",
"state": "NE",
"address2": "address2"
},
"dob": "1991-03-08 08:00:00",
"email": "tom@middle-earth.com",
"entity_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"first_name": "Tom",
"last_name": "Bombadil",
"phone_number": "+15555555555"
},
"nature_of_business": "nature_of_business",
"phone_number": "+15555555555",
"required_documents": [
{
"entity_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"status_reasons": [
"string"
],
"valid_documents": [
"string"
]
}
],
"status": "ACCEPTED",
"status_reasons": [
"ADDRESS_VERIFICATION_FAILURE"
],
"user_type": "BUSINESS",
"verification_application": {
"created": "2019-12-27T18:11:19.117Z",
"status": "ACCEPTED",
"status_reasons": [
"ADDRESS_VERIFICATION_FAILURE"
],
"updated": "2019-12-27T18:11:19.117Z"
},
"website_url": "website_url"
}
],
"has_more": true
}