Skip to main content
GET /v1/verifier/dc_sessions/{id} API Key

Get DC API session status

Retrieve the status and results of a DC API session.

This is the key endpoint for secure backend confirmation. After verification
completes, poll this endpoint from your backend to get the verified claims.
Never trust claims sent from the frontend - always confirm via this endpoint.

Requires Secret Key authentication from the same account that created the session.

Parameters

Name Location Type Description
id * path string Session UUID
X-API-Key * header string Secret API key for authentication

* Required parameter

Response

200 Session status (completed)

Content-Type: application/json

success boolean
data object

A DC API session for thin client credential verification

session_id string (uuid)

Unique identifier for the session

Example: cc5c6970-31d8-46af-af18-0e0b991d44b0

status string

Current status of the session: - pending: Awaiting wallet response - processing: Verification in progress - completed: Verification succeeded - failed: Verification failed

Allowed values: "pending", "processing", "completed", "failed"

Example: pending

verified boolean

Whether verification succeeded (only present when completed)

Example: true

trusted boolean

Whether the credential comes from a trusted issuer

Example: true

claims object nullable

Verified claims from the credential (only when completed)

Example: {"given_name":"Jane","family_name":"Doe","age_over_21":true}

issuer object nullable

Issuer information (only when completed)

name string

Issuer name

Example: State DMV

did string

Issuer DID

Example: did:web:dmv.state.gov

domain string nullable

Example: dmv.state.gov

domain_fully_verified boolean

Example: true

document_type string nullable

Document type identifier (e.g., org.iso.18013.5.1.mDL for Mobile Driver's License)

Example: org.iso.18013.5.1.mDL

expires_at string (date-time)

When the session expires

Example: 2026-01-15T10:05:00Z

created_at string (date-time)

When the session was created

Example: 2026-01-15T10:00:00Z

completed_at string (date-time) nullable

When verification completed (only when completed)

Example: 2026-01-15T10:01:30Z

render_url string (uri) nullable

Signed URL to render the credential visually (only when completed with claims)

Example: https://js.aho.com/v1/sessions/abc123/render?sig=xyz789

Code Examples

import os
from aho_sdk import AhoSdk

client = AhoSdk.verifier(api_key=os.environ["AHO_API_KEY"])

result = client.dc_sessions.get(
    id="example_id"
)

Try It

Log in to test this endpoint directly from the documentation.

Log in