# Agent Budget Guard - Budget Report

> Agent Budget Guard - Budget Report is a paid API for AI agents from agent-budget-guard.onrender.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-13).

Generates an audit-ready spending report for a specific AI agent, including payment history, classified invoices, and budget utilization metrics.

## Facts

- Endpoint: POST https://agent-budget-guard.onrender.com/api/budget/report/%7Bagent_id%7D
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-budget-guard-budget-report-08ea6881
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7HkUzF0UIbXVggezlepYq

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agent-budget-guard-budget-report-08ea6881 -d '<json body>'
```

Example prompt: Pull the full budget report for agent ID agent-007, I need to see its USDC spending history and invoice classifications for the audit.

## When to prefer this

Use this endpoint when you need a consolidated, audit-ready financial report for a specific AI agent operating with x402 pay-per-request governance, especially when USDC/Base payment tracking or JPY/JPYC compliance reporting is required.

## Known failure modes

- Unknown agent_id returns 404 not found
- Missing or invalid payment header returns 402 Payment Required
- Malformed agent_id path parameter returns 400 bad request
- No payment history found for agent returns empty report
- Service unavailable on Render free tier returns 503

## How this service works

Pay-per-request governance APIs for AI agents using x402. Check budgets, log payments, classify invoices, and generate audit-ready spending records. Built for autonomous agents, USDC/Base payments, and JPY/JPYC reporting workflows.

## Output

Returns a structured spending report for the specified agent ID, including a breakdown of USDC payments made via x402, classified invoice entries, cumulative budget usage, and audit-ready records suitable for JPY/JPYC reporting workflows.

## Example request

```json
{
 "period": "2024-01-01T00:00:00Z/2024-01-31T23:59:59Z",
 "agent_id": "agent_test_001",
 "currency": "USDC",
 "include_audit_trail": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-budget-guard-budget-report-08ea6881/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-budget-guard.onrender.com](https://www.zero.xyz/host/agent-budget-guard.onrender.com/llms.txt)
