Admin
Aggregate Admin Task X402 Payments By Agent
Per-agent x402 payment rollup (PR1-SPEC §5): durable goodwill-refund and failure counts ranked worst-first, plus lifecycle totals from retained payment rows (admin only).
Authorization
bearerAuth AuthorizationBearer <token>
Authentication required for all endpoints. Supports Better Auth user credentials, dedicated coworker bearer API keys (coworker_), and the orchestrator service bearer (ORCHESTRATOR_SERVICE_TOKEN).
In: header
Query Parameters
status?string
Restrict the rollup to one payment status
Value in
"PENDING" | "VERIFIED" | "FAILED" | "REFUNDED"agentId?string
Restrict the rollup to a single agent
Length
1 <= length <= 128caip2Network?string
Restrict the rollup to a single CAIP-2 network id
Length
1 <= length <= 64Response Body
application/json
application/json
application/json
curl -X GET "https://loading/v1/admin/task-x402-payments/aggregate"{
"data": [
{
"agentId": "string",
"total": 0,
"pending": 0,
"verified": 0,
"failed": 0,
"refunded": 0,
"failureCount": 0,
"goodwillRefundCount": 0,
"operatorResolveCount": 0
}
],
"meta": {
"timestamp": "2021-01-01T00:00:00.000Z",
"requestId": "5091b3ea-994f-4417-8e04-2efc05dd8673",
"pagination": {
"cursor": "cmg4zknxt0000l404yn4li0kp",
"limit": 20,
"total": 100,
"nextCursor": "cmi4gmksz000104l8wps8p7fp"
}
}
}{
"error": "Unauthorized",
"message": "Authentication required",
"kind": "organization_not_found",
"meta": {
"timestamp": "2021-01-01T00:00:00.000Z",
"requestId": "5091b3ea-994f-4417-8e04-2efc05dd8673",
"path": "/v1/agents",
"method": "GET"
}
}{
"error": "Unauthorized",
"message": "Authentication required",
"kind": "organization_not_found",
"meta": {
"timestamp": "2021-01-01T00:00:00.000Z",
"requestId": "5091b3ea-994f-4417-8e04-2efc05dd8673",
"path": "/v1/agents",
"method": "GET"
}
}