API BaaSIdentity Verification

Get an identity verification

Returns the tenant-scoped verification and its current state. The verificationLink is returned only while status is PENDING.

Requires a master M2M credential, the identity_verification.manage scope and X-Tenant-Id.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

verificationIdstringRequired
Standalone identity verification identifier returned by the creation endpoint.

Headers

X-Tenant-IdstringRequired
Tenant context used for authorization and routing.

Response

Current verification state.
verificationIdstring
Standalone verification identifier.
statusenum
Current state of the standalone verification.
Allowed values:
purposeenum
Sensitive journey that this proof is allowed to authorize.
Allowed values:
referenceIdstring

Caller-owned journey identifier supplied at creation.

documentstringformat: "^\d{11}$"
CPF verified by this journey, with 11 digits and no punctuation.
providerstring
Identity provider that processed the journey.
expiresAtdatetime
RFC 3339 instant at which the pending journey expires.
failureReasonenumOptional

Provider-normalized reason when the journey failed or expired; otherwise null or omitted.

Allowed values:
completedAtdatetime or nullOptional

Terminal transition time for APPROVED, FAILED or EXPIRED.

consumableUntildatetime or nullOptional

Last instant at which an approved result may be consumed. Set for APPROVED.

consumedAtdatetime or nullOptional

First successful consume time; null or omitted until consumption.

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error