LIVE DEMO · REAL API · NOTHING MAILED
Send a letter in sandbox mode
This page calls the real paperplane API from your browser — the same endpoints AI agents and scripts use. You’ll compose a tiny letter, get a priced quote, then run a sandbox send: the full pipeline (address checks, content screening, simulated printing and tracking) with no signup, no payment, and nothing physically mailed. Every request and response appears below, verbatim.
Along the way you’ll see the part worth stealing: the confirmation-token contract that makes it safe to hand this API to an AI agent. A send is never the first call — and you can watch it refuse a tampered letter.
Write a tiny letter
Edit anything. The recipient is fixed to a demo address (Maria Alvarez, 1 Main St, Richmond VA 23220) so this page cannot be used to spray real mailboxes, and nothing is mailed in sandbox anyway.
Get a real quote (free, read-only)
POST /v1/quotes prices the letter and, because we are sending the real recipient and content, mints a confirmation_token: a signed, single-use, 30-minute pass bound to exactly this letter at exactly this price. It is the only thing that can authorize a send.
Send it: sandbox, so it is free and nothing mails
POST /v1/orders with sandbox: true and the token. The server re-derives the token’s binding from the arguments it actually received. First, try sending a version of the letter with one sentence quietly added after quoting, and watch it refuse.
Get a quote first. A send is never the first call.
Track it
GET /v1/orders/:id is the read-only status lookup an agent polls: screening, printing, mailed, delivered. Sandbox orders run the same lifecycle on a simulated clock.
Complete the sandbox send first.
Where to go from here
- Mail something real: the send flow — from $1.99, no account.
- Wire up an agent: the MCP guide exposes these same three calls as tools.
- Build against the API: developer docs and the OpenAPI spec at
/v1/openapi.json.