---
title: "Structured pricing contract for programmatic callers"
method: GET
path: "/api/v1/pricing"
tags: ["Pricing"]
---

# Structured pricing contract for programmatic callers

`GET /api/v1/pricing`

## Request

- Base URL: `https://www.agenttax.io`
- URL: `https://www.agenttax.io/api/v1/pricing`
- Auth: none declared

Stable, versioned JSON contract. Agents can poll this to compute cost/margin before selecting a tier. `schema_version` follows semver — additive changes bump minor; breaking changes bump major and ship with a migration window.

## Response `200`

Pricing contract.

- PricingResponse
  - `schema_version` string, required
  - `updated_at` string, required: ISO date the contract was last revised.
  - `currency` 'USD', required
  - `tiers` PricingTier[], required
    - `id` string, required
    - `name` string, required
    - `price_usd_monthly` number, nullable, required
    - `monthly_calls_included` number, nullable, required
    - `overage_usd_per_call` number, nullable, required
    - `overage_policy` 'hard_cutoff' | 'meter' | 'custom', required
    - `features` string[], required
    - `stripe_price_id` string, nullable, required
    - `contact` string
  - `pay_per_call` PricingPayPerCall, required
    - `id` 'x402', required
    - `name` string, required
    - `price_usd_per_call` number, required
    - `network` string, required
    - `payee` string, nullable, required
    - `facilitator` string, required
    - `notes` string, required
  - `billing_provider` 'stripe', required
  - `docs` string, required

## Other responses

- `405`: Method not allowed (GET only).

---

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