Skip to main content
GET /v1/verifier/requests/{request_uuid}/responses/{uuid} API Key

Get response details

Retrieve detailed information about a specific presentation response,
including all disclosed claims and credential information.

Parameters

Name Location Type Description
request_uuid * path string Presentation request UUID
uuid * path string Response UUID
X-API-Key * header string Verifier API key for authentication

* Required parameter

Response

200 Response details

Content-Type: application/json

success boolean
data object

A holder's response to a presentation request

uuid * string (uuid)

Unique identifier for the response

Example: 08eb90df-d436-4214-82a9-cf67ce2158c4

status * string

Status of the response: - pending: Awaiting holder action - approved: Holder shared requested credentials - declined: Holder declined the request

Allowed values: "pending", "approved", "declined"

Example: approved

responded_at string (date-time) nullable

When the holder responded

Example: 2025-01-15T14:30:00Z

created_at * string (date-time)

When the response record was created

Example: 2025-01-15T14:25:00Z

holder object nullable

Information about the holder (if available)

name string

Holder's display name

Example: John Doe

disclosed_claims object nullable

Claims disclosed by the holder (detail view only)

Example: {"name":"John Doe","age_over_21":true}

claim_mapping object nullable

Mapping of claim names (detail view only)

credential object nullable

Source credential information (detail view only, if single credential)

uuid string (uuid)

Example: fa41d8af-469e-4aa8-8d96-e5e7401ea22d

type string

Credential type

Example: AgeVerificationCredential

issuer object
name string

Example: State DMV

did string

Example: did:web:dmv.state.gov

issued_at string (date-time)

Example: 2025-01-01T00:00:00Z

expires_at string (date-time) nullable

Example: 2030-01-01T00:00:00Z

credentials array[object] nullable

Multiple credentials (detail view only, for multi-credential responses)

Array items:

query_item_id string

ID from the DCQL query

Example: age_cred

credential object
uuid string (uuid)

Example: 93d1dc9b-84eb-4a0e-bede-9c0c66a75d8f

type string

Example: AgeVerificationCredential

disclosed_claims object

Example: {"over_21":true}

Code Examples

import os
from aho_sdk import AhoSdk

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

result = client.responses.get(
    request_uuid="example_request_uuid",
    uuid="example_uuid"
)

Try It

Log in to test this endpoint directly from the documentation.

Log in