/v1/holder/credentials
API Key
Paginated
List holder credentials
List all credentials accessible to the authenticated holder. This includes credentials
where the holder is the designated holder_account, the subject identifier matches their
email, or the credential is bound to one of their signing keys.
Parameters
| Name | Location | Type | Description |
|---|---|---|---|
page
|
query | integer | Page number for pagination (default: 1) |
per_page
|
query | integer | Items per page (default: 25, max: 100) |
status
|
query | string |
Filter by credential status
Values: active, suspended, revoked, expired, archived
|
sort
|
query | string |
Sort field
Values: status, issued_at, expires_at, created_at
|
direction
|
query | string |
Sort direction (default: desc)
Values: asc, desc
|
X-API-Key
*
|
header | string | API key for holder authentication |
* Required parameter
Response
Content-Type: application/json
success
boolean
data
array[object]
Array items:
uuid
string (uuid)
status
string
type
string
type_display
string
schema
object
nullable
Credential schema reference
uuid
string (uuid)
Schema UUID
Example: 28b9daa3-94b9-40fe-ab1b-a4315de20afc
name
string
Schema display name
Example: University Degree
type
string
Credential type identifier
Example: UniversityDegreeCredential
slug
string
URL-friendly schema identifier
Example: university-degree
issuer
object
name
string
did
string
domain
string
nullable
issued_at
string (date-time)
expires_at
string (date-time)
nullable
created_at
string (date-time)
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.holder(api_key=os.environ["AHO_API_KEY"])
result = client.credentials.listclient = AhoSdk.holder(api_key: ENV["AHO_API_KEY"])
result = client.credentials.listimport { AhoSdk } from '@aho/sdk';
const client = AhoSdk.holder({ apiKey: process.env.AHO_API_KEY });
const result = await client.credentials.list;curl -X GET 'https://api.aho.com/v1/holder/credentials' \
-H 'X-API-Key: $AHO_API_KEY'Try It
Log in to test this endpoint directly from the documentation.
Log in