{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "#/components/schemas/account-holder-updated", "title": "Account Holder Updated", "oneOf": [ { "title": "KYB Payload", "description": "KYB payload for an updated account holder.", "type": "object", "properties": { "token": { "description": "The token of the account_holder that was created.", "example": "00000000-0000-0000-0000-000000000001", "format": "uuid", "type": "string" }, "update_request": { "type": "object", "description": "Original request to update the account holder.", "properties": { "beneficial_owner_individuals": { "description": "You must submit a list of all direct and indirect individuals with 25% or more ownership in the company. A maximum of 4 beneficial owners can be submitted. If no individual owns 25% of the company you do not need to send beneficial owner information.\nSee [FinCEN requirements](https://www.fincen.gov/sites/default/files/shared/CDD_Rev6.7_Sept_2017_Certificate.pdf) (Section I) for more background on individuals that should be included.", "items": { "$ref": "#/components/schemas/individual" }, "minItems": 0, "type": "array" }, "business_entity": { "description": "Information for business for which the account is being opened and KYB is being run.", "$ref": "#/components/schemas/kyb-business-entity" }, "control_person": { "description": "An individual with significant responsibility for managing the legal entity (e.g., a Chief Executive Officer, Chief Financial Officer, Chief Operating Officer, Managing Member, General Partner, President, Vice President, or Treasurer). This can be an executive, or someone who will have program-wide access to the cards that Lithic will provide. In some cases, this individual could also be a beneficial owner listed above. See [FinCEN requirements](https://www.fincen.gov/sites/default/files/shared/CDD_Rev6.7_Sept_2017_Certificate.pdf) (Section II) for more background.", "$ref": "#/components/schemas/individual" } } }, "external_id": { "description": "A user provided id that can be used to link an account holder with an external system", "type": "string" }, "naics_code": { "description": "6-digit North American Industry Classification System (NAICS) code for the business. Only present if naics_code was included in the update request.", "example": "541512", "type": "string" }, "nature_of_business": { "description": "Short description of the company's line of business (i.e., what does the company do?). Values longer than 255 characters will be truncated before KYB verification", "example": "Software company selling solutions to the restaurant industry", "type": "string" }, "website_url": { "description": "Company website URL.", "example": "www.mybusiness.com", "type": "string" } }, "required": [ "token", "update_request" ], "additionalProperties": false }, { "title": "KYC Payload", "description": "KYC payload for an updated account holder.", "type": "object", "properties": { "token": { "description": "The token of the account_holder that was created.", "example": "00000000-0000-0000-0000-000000000001", "format": "uuid", "type": "string" }, "update_request": { "type": "object", "description": "Original request to update the account holder.", "properties": { "individual": { "$ref": "#/components/schemas/individual", "description": "Information on the individual for whom the account is being opened and KYC is being run." } } }, "external_id": { "description": "A user provided id that can be used to link an account holder with an external system", "type": "string" } }, "required": [ "token", "update_request" ], "additionalProperties": false }, { "title": "Legacy Payload", "description": "Legacy payload for an updated account holder.", "type": "object", "properties": { "business_account_token": { "description": "If applicable, represents the business account token associated with the account_holder.", "example": "00000000-0000-0000-0000-000000000001", "format": "uuid", "type": [ "string", "null" ] }, "created": { "description": "When the account_holder updated event was created", "format": "date-time", "type": "string" }, "email": { "description": "If updated, the newly updated email associated with the account_holder otherwise the existing email is provided.", "example": "johnny@lithic.com", "type": "string" }, "external_id": { "description": "If applicable, represents the external_id associated with the account_holder.", "example": "00000000-0000-0000-0000-000000000001", "type": [ "string", "null" ] }, "first_name": { "description": "If applicable, represents the account_holder's first name.", "example": "Johnny", "type": "string" }, "last_name": { "description": "If applicable, represents the account_holder's last name.", "example": "Appleseed", "type": "string" }, "legal_business_name": { "description": "If applicable, represents the account_holder's business name.", "example": "Lithic", "type": "string" }, "phone_number": { "description": "If updated, the newly updated phone_number associated with the account_holder otherwise the existing phone_number is provided.", "example": "+15555555555", "type": "string" }, "token": { "description": "The token of the account_holder that was created.", "example": "00000000-0000-0000-0000-000000000001", "format": "uuid", "type": "string" } }, "required": [ "token" ] } ] }