Update
Update account holder information and possibly resubmit for evaluation
patch/v1/account_holders/{account_holder_token}
Update the information associated with a particular account holder (including business owners and control persons associated to a business account). If Lithic is performing KYB or KYC and additional verification is required we will run the individual's or business's updated information again and return whether the status is accepted or pending (i.e., further action required). All calls to this endpoint will return a synchronous response. The response time will depend on the workflow. In some cases, the response may indicate the workflow is under review or further action will be needed to complete the account creation process. This endpoint can only be used on existing accounts that are part of the program that the calling API key manages.
Path Parameters
account_holder_tokenstring
formatuuid
Body Parameters
bodyunion
The KYB request payload for updating a business.
One of the following 3 object variants:
Returns
KYBKYCPatchResponseobject
PatchResponseobject
Request example Request
curl https://api.lithic.com/v1/account_holders/$ACCOUNT_HOLDER_TOKEN \
-X PATCH \
-H 'Content-Type: application/json' \
-H "Authorization: $LITHIC_API_KEY" \
-d '{
"nature_of_business": "Software company selling solutions to the restaurant industry",
"website_url": "www.mybusiness.com"
}'200 Example
{
"token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"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"
},
"government_id": "114-123-1513",
"legal_business_name": "Acme, Inc.",
"phone_numbers": [
"+15555555555"
],
"dba_business_name": "dba_business_name",
"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",
"first_name": "Tom",
"government_id": "111-23-1412",
"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"
},
"government_id": "114-123-1513",
"legal_business_name": "Acme, Inc.",
"phone_numbers": [
"+15555555555"
],
"dba_business_name": "dba_business_name",
"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",
"first_name": "Tom",
"government_id": "111-23-1412",
"last_name": "Bombadil",
"phone_number": "+15555555555"
},
"created": "2019-12-27T18:11:19.117Z",
"email": "email",
"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",
"first_name": "Tom",
"government_id": "111-23-1412",
"last_name": "Bombadil",
"phone_number": "+15555555555"
},
"nature_of_business": "nature_of_business",
"phone_number": "phone_number",
"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"
}