Beyond the standard required and optional field checks and data type validations, Lead performs additional validations.
The below list 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
| Validation | Description |
|---|
| Missing Decision Reason | Status is approved, declined, or canceled without decision_reason field also populated. |
| Missing Adverse Action Notice | Adverse action notices are required if status = declined. |
| Missing Credit Score Detail | Either all three credit score fields are provided or none are (credit_pulled_at, credit_score, credit_report_source) |
| Invalid Entity Reference on Terminal Application | References 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 application is in a terminal state. |
| May Not Change Terminal Application | Updates may not be made to applications in a terminal state. |
| Entity Role Mismatch For Approved Application | If the application is approved, role requirements for each entity must meet account holder / authorized signer / authorized user corresponding role requirements. |
Previous Application Has effective_at >= current application effective_at | On Application Update, effective at must be greater than the previous instance of this record. |
Future Enforcements
Lead expects partners to comply with the below validations; however we do not currently enforce them upon daily processing. We will provide you with 60 days notice before enforcing the following validations.
| Validation | Description |
|---|
| Invalid Namespace | client_application_id cannot start with application_ |
| Invalid Entities on Application | Account holders, Authorized Signers, and Authorized Users must have valid entity_id or client_customer_id if the application is in any terminal state. |
| Credit Limit Cannot Exceed Max Credit Limit | credit_limit <= max_credit_limit if both are provided |
| Missing Adverse Action Notice Detail | If status is in a terminal state either all three adverse action fields are provided or none are (aan_delivered_at, aan_reason, aan_delivery_method) |
| Invalid Application status transition | Updates to nonterminal applications must comply with valid status transitions |
