---
title: "Forge pricing and input schema (free, no payment)"
method: GET
path: "/api/x402/forge"
---

# Forge pricing and input schema (free, no payment)

`GET /api/x402/forge`

## Request

- Base URL: `https://three.ws`
- URL: `https://three.ws/api/x402/forge`
- Auth: none required

Free price/usage discovery for the Forge generation lane. Returns the per-tier USDC pricing, the accepted request body schema, and the free poll endpoint. No payment, no credentials, and no generation. POST the same path to actually generate.

## Response `200`

Price catalog and input schema

- object
  - `route` string, required
  - `description` string
  - `method` string, required: The verb that performs generation: POST.
  - `input_schema` object, required: JSON Schema for the POST request body.
  - `poll` string: Free endpoint for polling a job to completion.
  - `pricing_usdc` object[], required: One entry per quality tier.
    - `tier` 'draft' | 'standard' | 'high', required
    - `price_usdc` string, required

## Other responses

- `400`: A ?job= query landed here; poll on GET /api/forge?job=<id> instead

---

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