---
title: "Estimate Plan"
method: POST
path: "/v1/plan/estimate"
---

# Estimate Plan

`POST /v1/plan/estimate`

## Request

- Base URL: `https://agentpay.tools` (the document declares no server; this is the origin it was published from)
- URL: `https://agentpay.tools/v1/plan/estimate`
- Auth: none required

Price a plan of tool calls without executing or paying for anything.

Unknown tools don't fail the request — they come back with
exists=false so the agent can re-plan around them. External x402 URLs
are annotated (and priced when possible) from the Prober's telemetry.

## Request body

- PlanEstimateRequest
  - `steps` PlanStep[], required
    - `tool` string, required
    - `params` object
  - `budget` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/agentpay/apis/agentpay-gateway.md) · [All operations](https://skmtc.dev/agentpay/apis/agentpay-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/agentpay/apis/agentpay-gateway/revisions/d4dd864c820e?raw)
