/v1/verifier/requests/{request_uuid}/responses
API Key
Paginated
List responses for a presentation request
List all responses received for a specific presentation request.
Responses include holder-disclosed claims and verification status.
Parameters
| Name | Location | Type | Description |
|---|---|---|---|
request_uuid
*
|
path | string | Presentation request UUID |
status
|
query | string |
Filter by response status
Values: pending, approved, declined
|
page
|
query | integer | Page number |
per_page
|
query | integer | Results per page (default: 25, max: 100) |
X-API-Key
*
|
header | string | Verifier API key for authentication |
* Required parameter
Response
Content-Type: application/json
success
boolean
data
array[object]
Array items:
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}
meta
object
Pagination metadata for list responses
current_page
*
integer
Current page number
Example: 1
per_page
*
integer
Items per page
Example: 25
total_count
*
integer
Total number of items
Example: 42
total_pages
*
integer
Total number of pages
Example: 2
Code Examples
import os
from aho_sdk import AhoSdk
client = AhoSdk.verifier(api_key=os.environ["AHO_API_KEY"])
result = client.responses.list(
request_uuid="example_request_uuid"
)client = AhoSdk.verifier(api_key: ENV["AHO_API_KEY"])
result = client.responses.list(
request_uuid: "example_request_uuid"
)import { AhoSdk } from '@aho/sdk';
const client = AhoSdk.verifier({ apiKey: process.env.AHO_API_KEY });
const result = await client.responses.list({
requestUuid: "example_request_uuid"
});curl -X GET 'https://api.aho.com/v1/verifier/requests/example_request_uuid/responses' \
-H 'X-API-Key: $AHO_API_KEY'Try It
Log in to test this endpoint directly from the documentation.
Log in