Retrieve an account validation

Returns the current state of a previously-submitted validation. Use this to poll a pending validation until it reaches a terminal status (verified, name_mismatch, not_found, not_available, or error).

Authentication

AuthorizationBearer
OAuth 2.0 access token

Path parameters

idstringRequiredformat: "uuid"

Validation ID returned by POST /accounts/validate

Response

Current validation state
idstringformat: "uuid"

Validation ID — use with GET /accounts/validate/{id} to poll a pending validation.

statusenum

Validation outcome. pending means the upstream provider is still resolving; poll GET /accounts/validate/{id} until terminal.

providerstring

Which connector produced the result (e.g. flutterwave, sandbox).

accountHolderNamestring

Name returned by the provider, populated for verified / name_mismatch.

validationTypeenum

Where the result came from — internal_rules = format check (e.g. NUBAN check digit), external = upstream provider lookup.

expiresAtdatetime

ISO-8601 timestamp at which the cached result becomes stale.

failureReasonstring

Free-form provider reason; populated for not_found / name_mismatch / error.

Errors

401
Unauthorized Error
404
Not Found Error
500
Internal Server Error