Skip to main content
Beyond the standard required and optional field checks and data type validations, Lead performs additional validations. The list below is non-exhaustive — we aim to be thoughtful and robust in validations that ensure high data quality to enable us to provide effective oversight.

Enforced Today

ValidationDescription
Missing Status Reasonstatus_reason must be populated and consistent with status. Closed accounts must use a closed reason (entity_closed, client_closed, paid_off, charged_off, canceled).
Missing Adverse Action NoticeAdverse action notice fields (aan_delivered_at, aan_reason, aan_delivery_method) are required if status_reason = client_closed.
Missing Credit Score DetailEither all three credit score fields are provided or none (credit_pulled_at, credit_score, credit_report_source).
Invalid Entity Reference on Closed AccountReferences to account holders, authorized signers, and authorized users by client_customer_id or entity_id must refer to entities that have already been submitted to Lead if the account is in a closed state.
May Not Change Closed AccountUpdates may not be made to accounts in a closed state. A closed account cannot be re-opened.
Entity Role Mismatch for AccountEach entity referenced on the account must meet the role requirements for account_holder, authorized_signer, or authorized_user as appropriate.
Previous Account Has effective_at >= current Account effective_atOn account update, effective_at must be greater than the previous instance of this record.

Future Enforcements

Lead expects partners to comply with the validations below; however we do not currently enforce them upon daily processing. We will provide you with 60 days notice before enforcing the following validations.
ValidationDescription
Invalid Namespaceclient_account_id cannot start with account_, subledgered_account_, or partner_ledgered_account_ (reserved for Lead-generated account IDs).
Invalid Entities on AccountAccount holders, authorized signers, and authorized users must have a valid entity_id or client_customer_id if the account is in a closed state.
Credit Limit Cannot Exceed Max Credit Limitcredit_limit <= max_credit_limit if both are provided.
Missing Adverse Action Notice DetailIf status_reason = client_closed, either all three adverse action notice fields are provided or none (aan_delivered_at, aan_reason, aan_delivery_method).
Invalid Account Status TransitionUpdates to non-closed accounts must comply with valid status transitions.