---
title: "Public, unauthenticated endpoint returning the plan grid, top-up pricing, and per-check token costs."
method: GET
path: "/api/config"
tags: ["config"]
---

# Public, unauthenticated endpoint returning the plan grid, top-up pricing, and per-check token costs.

`GET /api/config`

## Request

- Base URL: `https://api.pricklymails.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.pricklymails.com/api/config`
- Auth: none declared

## Response `200`

Public pricing and plan configuration.

- ConfigResponse: JSON response body for `GET /api/config`.
  - `checks` CheckCostsResponse, required: Public per-check token cost. Field names are the check names.
    - `catchall` integer, required: Token cost of the `catchall` check.
    - `disposable` integer, required: Token cost of the `disposable` check.
    - `free` integer, required: Token cost of the `free` check.
    - `mx` integer, required: Token cost of the `mx` check.
    - `role` integer, required: Token cost of the `role` check.
    - `smtp` integer, required: Token cost of the `smtp` check.
    - `syntax` integer, required: Token cost of the `syntax` check.
  - `plans` PlanConfigResponse[], required: One entry per real plan, in tier order (Free through Enterprise).
    - `allowed_agent_scopes` string[], required: The scopes an agent (a non-human principal) under this plan may be granted, as scope strings such as `"results:read"`.
    - `allowed_checks` string[], required: The verification checks an API key or agent credential under this plan may enable, as check names such as `"smtp"`.
    - `batch_max` integer, required: Maximum batch size for a single bulk-verification submission.
    - `code` string, required: Plan code (e.g. `"free"`, `"starter"`, `"pro"`, `"business"`, `"enterprise"`).
    - `max_agents` integer, required: Maximum number of active agents (non-human principals authenticating through a scoped credential).
    - `max_api_keys` integer, required: Maximum number of active API keys.
    - `max_webhooks` integer, required: Maximum number of webhook endpoints, whatever their status (paused and disabled endpoints count too); 0 on Free.
    - `monthly_price_cents` integer, required: Monthly price in cents.
    - `monthly_tokens` integer, required: Monthly token grant credited to the account's token balance on each billing cycle.
    - `rate_limit_per_minute` integer, required: API rate limit in requests per minute.
    - `yearly_price_cents` integer, required: Yearly price in cents (11 months for 12).
  - `topup` TopupConfigResponse, required: Token top-up pricing.
    - `max_tokens` integer, required: Maximum token quantity purchasable in a single top-up.
    - `min_tokens` integer, required: Minimum token quantity purchasable in a single top-up.
    - `step_tokens` integer, required: Required quantity increment; a top-up quantity must be a multiple of this value (identical to `tokens_per_euro`, so every charge is a whole number of cents).
    - `tokens_per_euro` integer, required: Number of tokens that map to one euro (e.g. `1000` = 0.001 EUR/token).

---

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