/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
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"
)
client = AhoSdk.verifier(api_key: ENV["AHO_API_KEY"])
result = client.responses.get(
request_uuid: "example_request_uuid",
uuid: "example_uuid"
)
import { AhoSdk } from '@aho/sdk';
const client = AhoSdk.verifier({ apiKey: process.env.AHO_API_KEY });
const result = await client.responses.get({
requestUuid: "example_request_uuid",
uuid: "example_uuid"
});
curl -X GET 'https://api.aho.com/v1/verifier/requests/example_request_uuid/responses/example_uuid' \
-H 'X-API-Key: $AHO_API_KEY'
Try It
Log in to test this endpoint directly from the documentation.
Log in