Release the presentation a wallet returned, to Evidence
const url = 'https://example.com/v1/presentations/read';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"principal":{"issuer":"example","subject":"example"},"reference":"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/presentations/read \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "principal": { "issuer": "example", "subject": "example" }, "reference": "example" }'Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”object
object
Example generated
{ "principal": { "issuer": "example", "subject": "example" }, "reference": "example"}Responses
Section titled “Responses”The presentation and the session context; the first successful read consumes the result
object
object
object
DCQL credential query id to the presented credentials, as received.
object
Example generated
{ "context": { "clientId": "example", "createdBy": { "issuer": "example", "subject": "example" }, "nonce": "example", "policyId": "example", "receivedAt": "2026-04-15T12:00:00Z", "responseKeyThumbprint": "example", "responseUri": "https://example.com" }, "presentation": { "additionalProperty": [ "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 does not name a reference and the applicant principal
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 Evidence service credential 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.
Unknown, expired, already read, or created by another principal
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 wallet has not presented yet
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.
The wallet reported an error instead of presenting; the first read consumes the result
object
Example
{ "category": "access_denied"}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.
Reads are arriving 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.
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.