> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mermail.app/llms.txt
> Use this file to discover all available pages before exploring further.

# x402 pricing

> See per-call prices for hosted agent mailboxes, free reads, payment quotes, and safe retries.

The [Agent Marketplace API](https://docs.mermail.app/ai/agent-marketplace.md) lets an agent create and use
hosted mailboxes through wallet-based payments. You do not need a Mermail API key
or a monthly Developer or Growth subscription for this API.

**Base URL:** `https://console.mermail.app/api/agent/v1`

## Per-call prices

Prices below are the default USD listing prices, verified against the public
catalog on November 17, 2026. Payment uses an asset and network offered in the
live challenge, such as USDC.

> [!NOTE]
>
> The live `402` response's `accepts[]` is the authoritative x402 quote. Check its
> amount, asset, network, and recipient before approving payment. Do not hardcode
> a token or network from an example.

Paths below are relative to the base URL, except the discovery entry `/api`.

| Operation | Method and path | Price per call |
| - | - | -: |
| Create a hosted mailbox | `POST /mailboxes` | \$2.00 |
| Send an email | `POST /mailboxes/{mailboxId}/emails` | \$0.01 |
| Reply to an email | `POST /mailboxes/{mailboxId}/emails/{emailId}/reply` | \$0.01 |
| Forward an email | `POST /mailboxes/{mailboxId}/emails/{emailId}/forward` | \$0.01 |
| Save a draft | `POST /mailboxes/{mailboxId}/drafts` | \$0 |
| List mailboxes | `GET /mailboxes` | \$0 |
| Get a mailbox | `GET /mailboxes/{mailboxId}` | \$0 |
| List messages | `GET /mailboxes/{mailboxId}/emails` | \$0 |
| Get a message | `GET /mailboxes/{mailboxId}/emails/{emailId}` | \$0 |
| Get safe message context | `GET /mailboxes/{mailboxId}/emails/{emailId}/context` | \$0 |
| Search messages | `GET /mailboxes/{mailboxId}/search` | \$0 |
| Get a thread | `GET /mailboxes/{mailboxId}/threads/{threadId}` | \$0 |
| Download an attachment | `GET /mailboxes/{mailboxId}/attachments/{attachmentId}` | \$0 |
| List folders | `GET /mailboxes/{mailboxId}/folders` | \$0 |
| List custom labels | `GET /mailboxes/{mailboxId}/custom-labels` | \$0 |
| Discover the API | `GET https://console.mermail.app/api` | \$0 |

For example, creating one mailbox and making 100 send calls costs \*\*$3.00** at
these rates: $2.00 + (100 × $0.01). Reads and saved drafts add $0. This is the
Mermail operation total; any separately quoted wallet or network fees are not
included. Sending and storage limits still apply.

## Why a free call returns 402

Calls without a payment credential return `402 Payment Required`, including
reads, saved drafts, and discovery. At the default \$0 price, the signed x402
response proves the wallet identity without charging tokens. Free does not mean
anonymous: a wallet can access only its own mailboxes.

Retry with the signed `PAYMENT-SIGNATURE` credential. Paid creates and sends can
also use MPP when the live challenge offers `WWW-Authenticate: Payment`; MPP
clients use `Payment-Authorization`. Send one payment credential, not both.
The \$0 operations use x402.

## What the payment includes

Each distinct successful create operation creates a new hosted mailbox. The
wallet-bound workspace supports up to **50 hosted mailboxes**. Mailboxes use
verification mode with automations off.

This API does not include custom domains, workspace administration, scheduled
sending, webhooks, mailbox chat, task triage, MCP, or Agent Wallet access. Use a
[workspace plan](https://docs.mermail.app/pricing.md) for those workflows. Paying per call does not remove
the marketplace's sending, storage, or rate limits.

## Retry without buying twice

Use a stable `Idempotency-Key` for a paid operation. After a timeout or uncertain
result, retain the same key, request body, and original payment credential when
retrying that operation at the same path.

If the response is `409` with `payment_recovery_required`, recover the original
payment credential or [contact support](https://docs.mermail.app/resources/support.md). Do not create a
second payment to retry the same purchase. A new create request can buy another
mailbox.

## x402 payments and API credits

| API | Credential | What a 402 means |
| - | - | - |
| `/api/agent/v1` and discovery `GET /api` | Wallet payment or \$0 identity handshake | Follow the payment challenge |
| `/api/v1` | `x-api-key` | `credits_exhausted` means the workspace API credit allowance is depleted |

Marketplace charges do not debit the subscription API credit pool. Subscription
credits do not pay marketplace charges. See [Pricing](https://docs.mermail.app/pricing.md#api-credits) for
workspace API allowances.

For request bodies and setup, see [Agent Marketplace](https://docs.mermail.app/ai/agent-marketplace.md).
For the machine-readable catalog, use the
[public OpenAPI document](https://console.mermail.app/openapi.json).
If you want your agent to pay another service, see
[Agent Wallet x402 payments](https://docs.mermail.app/agent-wallet/swaps-and-x402.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.