---
title: "Agent Spend-Policy Simulator"
method: POST
path: "/v1/tools/simulate_spend_policy"
tags: ["TODO_TAGS_REVIEW", "TODO_AP2_EXPORT_REVIEW"]
---

# Agent Spend-Policy Simulator

`POST /v1/tools/simulate_spend_policy`

## Request

- Base URL: `https://ainumbers.co`
- URL: `https://ainumbers.co/v1/tools/simulate_spend_policy`
- Auth: none declared

Simulates thousands of synthetic agent transactions against a user-authored spend policy (per-merchant caps, category allow/deny, velocity limits, cumulative ceilings). Flags scope creep and AP2 v0.2 Human-Not-Present policy-bypass paths.

**Tool URL:** https://ainumbers.co/chaingraph/art-02-agent-spend-policy-simulator.html

## Request body

- object
  - `allowed_methods` unknown
  - `blocked_categories` unknown, required
  - `blocked_merchants` unknown, required
  - `chaos` unknown, required
  - `daily_limit` unknown, required
  - `drip_freq` unknown, required
  - `hnp_ratio` unknown, required
  - `hour_restriction` unknown
  - `monthly_limit` unknown, required
  - `n_txns` unknown, required
  - `per_tx_limit` unknown, required
  - `seed` unknown, required

## Response `200`

Successful tool execution result

- object
  - `bypass_paths_detected` unknown[]
    - unknown
  - `compliance_flags` string[]
  - `fail_count` integer
  - `fail_rate_pct` number
  - `pass_count` integer
  - `top_fail_reasons` object
    - `EXCEEDS_DAILY_LIMIT` integer
    - `EXCEEDS_MONTHLY_LIMIT` integer
    - `EXCEEDS_PER_TX_LIMIT` integer
  - `total_approved_spend` number
  - `total_transactions` integer
  - `verdict` string

---

[API](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite.md) · [All operations](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/llms.txt) · [OpenAPI document](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/revisions/b462e4f5bb28?raw)