Start one presentation exchange for the authenticated applicant
const url = 'https://example.com/v1/sessions';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"policy":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/v1/sessions \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "policy": "example" }'Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”object
Example generated
{ "policy": "example"}Responses
Section titled “Responses”Session created
object
Openid4vp://authorize?client_id=…&request_uri=…
Example generated
{ "expiresAt": "2026-04-15T12:00:00Z", "reference": "example", "requestUri": "https://example.com", "walletInvocation": "example"}Headers
Section titled “Headers”The W3C Trace Context version 0 field of the request, or a server-created one when the request carried none or an invalid or repeated one. tracestate is never answered.
The body is not a JSON object with one policy member
object
Example generated
{ "detail": "example", "status": 1, "title": "example", "type": "https://example.com"}Headers
Section titled “Headers”The W3C Trace Context version 0 field of the request, or a server-created one when the request carried none or an invalid or repeated one. tracestate is never answered.
The applicant token is missing or refused
object
Example generated
{ "detail": "example", "status": 1, "title": "example", "type": "https://example.com"}Headers
Section titled “Headers”The W3C Trace Context version 0 field of the request, or a server-created one when the request carried none or an invalid or repeated one. tracestate is never answered.
The configured request deadline elapsed
object
Example generated
{ "detail": "example", "status": 1, "title": "example", "type": "https://example.com"}Headers
Section titled “Headers”The W3C Trace Context version 0 field of the request, or a server-created one when the request carried none or an invalid or repeated one. tracestate is never answered.
The request body exceeds the configured byte limit
object
Example generated
{ "detail": "example", "status": 1, "title": "example", "type": "https://example.com"}Headers
Section titled “Headers”The W3C Trace Context version 0 field of the request, or a server-created one when the request carried none or an invalid or repeated one. tracestate is never answered.
The request is not application/json
object
Example generated
{ "detail": "example", "status": 1, "title": "example", "type": "https://example.com"}Headers
Section titled “Headers”The W3C Trace Context version 0 field of the request, or a server-created one when the request carried none or an invalid or repeated one. tracestate is never answered.
No presentation policy has this identifier
object
Example generated
{ "detail": "example", "status": 1, "title": "example", "type": "https://example.com"}Headers
Section titled “Headers”The W3C Trace Context version 0 field of the request, or a server-created one when the request carried none or an invalid or repeated one. tracestate is never answered.
The applicant is creating sessions too quickly
object
Example generated
{ "detail": "example", "status": 1, "title": "example", "type": "https://example.com"}Headers
Section titled “Headers”The W3C Trace Context version 0 field of the request, or a server-created one when the request carried none or an invalid or repeated one. tracestate is never answered.
Session secrets or the request identity could not be produced
object
Example generated
{ "detail": "example", "status": 1, "title": "example", "type": "https://example.com"}Headers
Section titled “Headers”The W3C Trace Context version 0 field of the request, or a server-created one when the request carried none or an invalid or repeated one. tracestate is never answered.
The session store is full, the audit destination is stopped, or the token issuer is unavailable
object
Example generated
{ "detail": "example", "status": 1, "title": "example", "type": "https://example.com"}Headers
Section titled “Headers”The W3C Trace Context version 0 field of the request, or a server-created one when the request carried none or an invalid or repeated one. tracestate is never answered.