Skip to content
Registry StackDocsv0.46.0

Read the state of a session the applicant created

GET
/v1/sessions/{reference}
curl --request GET \
--url https://example.com/v1/sessions/example \
--header 'Authorization: Bearer <token>'
reference
required
string

Session status, never the presented content

Media typeapplication/json
object
expiresAt
required
string format: date-time
failureCategory

Present only when the session failed on a wallet error.

Allowed values: access_denied invalid_request invalid_client vp_formats_not_supported wallet_unavailable other
policy
required
string
status
required
Allowed values: pending received failed

Example

{
"failureCategory": "access_denied",
"status": "pending"
}
Cache-Control
string
Allowed value: no-store
Traceparent
string
/^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$/

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

Media typeapplication/problem+json
object
detail
string
status
required
integer
title
required
string
type
required
string format: uri

Example generated

{
"detail": "example",
"status": 1,
"title": "example",
"type": "https://example.com"
}
Cache-Control
string
Allowed value: no-store
Traceparent
string
/^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$/

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.

WWW-Authenticate
string
Allowed value: Bearer

Unknown, expired, or created by another applicant

Media typeapplication/problem+json
object
detail
string
status
required
integer
title
required
string
type
required
string format: uri

Example generated

{
"detail": "example",
"status": 1,
"title": "example",
"type": "https://example.com"
}
Cache-Control
string
Allowed value: no-store
Traceparent
string
/^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$/

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

Media typeapplication/problem+json
object
detail
string
status
required
integer
title
required
string
type
required
string format: uri

Example generated

{
"detail": "example",
"status": 1,
"title": "example",
"type": "https://example.com"
}
Cache-Control
string
Allowed value: no-store
Traceparent
string
/^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$/

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 token issuer is unavailable

Media typeapplication/problem+json
object
detail
string
status
required
integer
title
required
string
type
required
string format: uri

Example generated

{
"detail": "example",
"status": 1,
"title": "example",
"type": "https://example.com"
}
Cache-Control
string
Allowed value: no-store
Retry-After
integer
>= 1
Traceparent
string
/^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$/

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.