Account Holder

Update account holder information and possibly resubmit for evaluation

Changed on Oct 20, 2026

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.

patch/v1/account_holders/{account_holder_token}

Request

Base URL
https://sandbox.lithic.com
URL
https://sandbox.lithic.com/v1/account_holders/{account_holder_token}
Auth
API key in header Authorization

Path parameters

account_holder_tokenstring uuid required

Globally unique identifier for the account holder.

Request body

Example request

{
  "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",
      "government_id": "111-23-1412"
    }
  ],
  "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",
    "government_id": "111-23-1412"
  },
  "naics_code": "541512",
  "nature_of_business": "Software company selling solutions to the restaurant industry",
  "website_url": "www.mybusiness.com"
}

Response

Example response

{
  "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",
    "government_id": "111-23-1412"
  },
  "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"
    ]
  },
  "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",
      "government_id": "111-23-1412"
    }
  ],
  "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",
    "government_id": "111-23-1412"
  }
}

Changes

Oct 20, 20269798275dc379 Revision changes
- breaking
  the ///// request property's minLength was increased from 0 to 1
- breaking
  the ///// request property's minLength was increased from 0 to 1
- breaking
  the /// request property's minLength was increased from 0 to 1
- breaking
  the /// request property's minLength was increased from 0 to 1
- breaking
  the //// request property's minLength was increased from 0 to 1
- breaking
  the //// request property's minLength was increased from 0 to 1
- breaking
  the //// request property's minLength was increased from 0 to 1
- breaking
  the //// request property's minLength was increased from 0 to 1
- breaking
  the // request property's minLength was increased from 0 to 1
- breaking
  the // request property's minLength was increased from 0 to 1
- breaking
  the response property ///// became nullable for the status
- breaking
  the response property ///// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property ///// became optional for the status
- breaking
  the response property ///// became optional for the status
- breaking
  the response property //// became optional for the status
- breaking
  the response property //// became optional for the status
- breaking
  the response property //// became optional for the status
- breaking
  the response property //// became optional for the status
- breaking
  the response property //// became optional for the status
- breaking
  the response property //// became optional for the status
- breaking
  the response property // became optional for the status
- breaking
  the response property // became optional for the status
- warning
  the ///// request property's maxLength was set to 16
- warning
  the ///// request property's maxLength was set to 30
- warning
  the /// request property's maxLength was set to 16
- warning
  the /// request property's maxLength was set to 30
- warning
  the //// request property's maxLength was set to 16
- warning
  the //// request property's maxLength was set to 30
- warning
  the //// request property's maxLength was set to 16
- warning
  the //// request property's maxLength was set to 30
- warning
  the // request property's maxLength was set to 16
- warning
  the // request property's maxLength was set to 30
- info
  the request property ///// became nullable
- info
  the request property ///// became nullable
- info
  the request property /// became nullable
- info
  the request property /// became nullable
- info
  the request property //// became nullable
- info
  the request property //// became nullable
- info
  the request property //// became nullable
- info
  the request property //// became nullable
- info
  the request property // became nullable
- info
  the request property // became nullable
May 18, 2026f70ff267a5d5 Revision changes
- breaking
  the response property /// became nullable for the status

Operation history