GET /v1/agent/requests/{support_reference}
Bearer self-service. Resolve one of your own requests by the UUID in X-Pzero-Support-Reference from the inference response.
X-Pzero-Request-Id is on every inference response. X-Pzero-Support-Reference appears only where a lookupable attempt row exists (not on video readiness polls, and not on failures before the key resolves). Buffered responses also carry cost headers; streams emit cost as a pzero.cost frame (see POST /v1/chat/completions).
Request
bash
curl "https://api.pzero.studio/v1/agent/requests/<support_reference>" \
-H "Authorization: Bearer pzero_..."Response
| Field | Meaning |
|---|---|
supportReference | Same UUID as X-Pzero-Support-Reference |
requestId | Same UUID as X-Pzero-Request-Id |
occurredAt | When the attempt was recorded (RFC3339) |
model | Requested model id |
modality | text, image, or video |
status | success, no_capacity, insufficient_balance, provider_error, or system_error |
httpStatus | HTTP status of the inference call |
errorCode | Structured error code when present |
errorMessage | Human-readable error when present |
costUsdc | Settled cost; absent when nothing cleared |
clearingPriceCents | Ask cleared at; absent when nothing cleared |
diemCleared | DIEM cleared |
totalMs / inferenceMs | Timings when recorded |
Primary use: recover streamed completion cost after the fact.
Unknown UUID, malformed UUID, or a reference owned by another account → 404 (foreign refs look the same as missing). Invalid UUID format → 400.