Skip to content

Receive a wallet VP response.

POST
/vp/response
Code sample: Shell / cURL
curl --request POST \
--url https://auth.example.com/vp/response \
--header 'Content-Type: application/json' \
--data '{ "vp_token": "example", "state": "g1:apac:3:vp_550e8400-e29b-41d4-a716-446655440000", "presentation_submission": {} }'
object
vp_token
required

Wallet presentation token, typically an SD-JWT VC with key binding.

string
state
required

The VP request id returned as state.

string
Example
g1:apac:3:vp_550e8400-e29b-41d4-a716-446655440000
presentation_submission
object

Verified VP response.

Media type application/json
object
success
required
boolean
request_id
required
string
disclosed_claims
object
key
additional properties
haip_compliant
boolean
Example
{
"success": true,
"request_id": "g1:apac:3:vp_550e8400-e29b-41d4-a716-446655440000",
"disclosed_claims": {
"email": "[email protected]",
"age_over_18": true
},
"haip_compliant": true
}

Error response.

Media type application/json
object
error
required
string
error_description
required
string
Example
{
"error": "invalid_request",
"error_description": "The request is invalid."
}

Error response.

Media type application/json
object
error
required
string
error_description
required
string
Example
{
"error": "invalid_request",
"error_description": "The request is invalid."
}