GET
/
v1
/
verifications
/
{id}
/
status
Get verification status (client-side)
curl --request GET \
  --url https://sandbox.authbound.io/v1/verifications/{id}/status \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Authbound-Publishable-Key: <api-key>'
{
  "object": "verification_status",
  "id": "<string>",
  "client_action": {
    "data": "<string>",
    "expires_at": "2023-11-07T05:31:56Z"
  },
  "return_url": "<string>"
}

Authorizations

Authorization
string
header
required

Opaque verification-scoped client token. Returned when creating a verification. Treat it as a bearer secret and do not depend on its internal format.

X-Authbound-Publishable-Key
string
header
required

Browser-safe publishable key. Format: pk_live_* (production) or pk_test_* (testing).

Path Parameters

id
string
required

Verification ID. Runtime IDs may be UUIDs during alpha; external IDs use vrf_*.

Pattern: ^(vrf_[a-zA-Z0-9_-]+|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$

Response

Verification status

Lightweight status for client-side polling

object
enum<string>
required
Available options:
verification_status
id
string
required
status
enum<string>
required
Available options:
created,
awaiting_user,
awaiting_provider,
processing,
verified,
failed,
canceled,
expired
failure_code
enum<string> | null
Available options:
presentation_invalid,
credential_expired,
credential_revoked,
issuer_untrusted,
policy_not_satisfied,
processing_timeout,
provider_error,
user_declined,
wallet_error,
null
client_action
object

Present only while the verification can still be handed to a wallet. Terminal statuses never include wallet handoff data.

return_url
string<uri>

Where the hosted verification page sends the user once the verification finishes, as given on create.

Maximum string length: 2048