The two checks
An application passes through two checks, in order, and the status tells you which one it is sitting in.- Can a credit report be retrieved, and does it match the application?
CREDIT_FREEZEandNO_HITare failures of this step. Identity has not been assessed yet. - Does the identification match the applicant?
PENDINGwith apendingReasonis a failure of this step.
Only the consumer can clear most of these. Your integration should surface the status to the
consumer and let them resolve it in the application flow — not queue it for merchant action. See
Resolving Pending Applications.
Status reference
Terminal statuses
An expired application may receive a Statement of Credit Denial, Termination, or Change (SCDTC).
Expiry is not a decline — no credit decision was reached.
Example responses
Base URL shown is the test environment. See Testing for credentials and the sandbox.Credit freeze
No hit
PATCH with corrected applicant data re-runs the lookup. Supplying a full SSN, a previous last
name or a previous address is what usually resolves it.
Identity verification
Returned onPATCH when identity verification is the pending reason.
Unresolved data mismatch
Handling these in your integration
- Do not poll aggressively while an application is pending. The consumer is working through a resolution flow that can take minutes or days.
- Do not treat a pend as a decline. Applications only pend if they otherwise meet the finance program’s criteria for approval.
- Do not re-submit a new application to clear a pend. A duplicate creates its own problems and the original stays open for its full 30 days.
- Surface the reason to the consumer, and link them to the resolution steps on the consumer FAQ.