Get a list of individual or business account holders

get

https://sandbox.lithic.com/v1/account_holders

Get a list of individual or business account holders and their KYC or KYB evaluation status.

Query Params

external_id

uuid

If applicable, represents the external_id associated with the account_holder.

limit

integer

The number of account_holders to limit the response to.

first_name

string

(Individual Account Holders only) The first name of the account holder. The query is case insensitive and supports partial matches.

last_name

string

(Individual Account Holders only) The last name of the account holder. The query is case insensitive and supports partial matches.

legal_business_name

string

(Business Account Holders only) The legal business name of the account holder. The query is case insensitive and supports partial matches.

phone_number

string

Phone number of the account holder. The query must be an exact match.

string

Email address of the account holder. The query must be an exact match, case insensitive.

ending_before

string

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.

starting_after

string

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.

begin

date-time

Date string in RFC 3339 format. Only entries created after the specified time will be included. UTC time zone.

end

date-time

Date string in RFC 3339 format. Only entries created before the specified time will be included. UTC time zone.

Responses


User has not been authenticated	Invalid or missing API key
API key is not active	The API key used is no longer active
Could not find API key	The API key provided is not associated with any user
Please provide API key in Authorization header	The Authorization header is not in the request
Please provide API key in the form Authorization: [api-key]	The Authorization header is not formatted properly
Insufficient privileges. Issuing API key required	Write access requires an Issuing API key. Reach out at lithic.com/contact
Insufficient privileges to create virtual cards.	Creating virtual cards requires an additional privilege


Rate limited, too many requests per second	User has exceeded their per second rate limit
Rate limited, reached daily limit	User has exceeded their daily rate limit
Rate limited, too many keys tried	One IP has queried too many different API keys

200OK