Get VP request status.

GET

/vp/requests/{id}

Code sample: Shell / cURL

curl --request GET \
  --url https://auth.example.com/vp/requests/example

Parameters

Path Parameters

id

required

string

Responses

200

VP request status.

Media type application/json

object

request_id

required

string

status

required

string

Allowed values: pending received verified failed expired

created_at

string format: date-time

expires_at

required

string format: date-time

verified_claims

object

key

additional properties

error

string

error_description

string

Example

{
  "request_id": "g1:apac:3:vp_550e8400-e29b-41d4-a716-446655440000",
  "status": "pending",
  "created_at": "2026-02-03T04:00:00.000Z",
  "expires_at": "2026-02-03T04:05:00.000Z",
  "verified_claims": {
    "email": "[email protected]"
  },
  "error": "verification_failed",
  "error_description": "The VP token could not be verified."
}

400

Error response.

Media type application/json

object

error

required

string

error_description

required

string

Example

{
  "error": "invalid_request",
  "error_description": "The request is invalid."
}

500

Error response.

Media type application/json

object

error

required

string

error_description

required

string

Example

{
  "error": "invalid_request",
  "error_description": "The request is invalid."
}