List delegations
List YOUR delegations, newest first. There is deliberately no public enumeration over anyone else's delegations — the public read shape is a point lookup of a handle you already hold (GET /api/v1/proofs/{id}/status accepts ph_dlg_*). Every item carries the DERIVED effective_status and is_valid beside its stored status, the same pair the detail returns: a delegation whose domain control proof was revoked, suspended or expired — or whose OWN lifetime has run out — reports that here even though its own status is untouched. Render effective_status. Returns 503 delegation_status_unavailable if that cascade cannot be resolved — a page is never served with stored statuses standing in for derived ones.
Request
- Base URL: https://api.proof.holdings
- URL: https://api.proof.holdings/api/v1/delegations
- Auth: one of:
- HTTP bearer
- API key in cookie auth_token
Query parameters
Page number (default 1)
Page size (default 20, max 100)
Filters the delegation's OWN stored record — whether you revoked it yourself. It deliberately does NOT filter on the derived effective_status: that cascade spans two collections and cannot be expressed in the query, and filtering it after the fact would punch holes in both the page and its total. ?status=active therefore still returns a delegation whose control proof died; read effective_status on each item.
Response
Your delegations
Example response
{
"data": [
{
"id": "507f1f77bcf86cd799439011",
"delegation_id": "ph_dlg_0123456789abcdef0123456789abcdef",
"principal": "postmark.com",
"delegate": {
"value": "pkg:npm/postmark-mcp"
},
"scope": [
"send-email"
],
"control_proof": "ph_ctl_0123456789abcdef0123456789abcdef"
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.