# Meirra API > The Meirra API is a pay-as-you-go REST API for email verification, contact and company enrichment, lead search, SEO data and AI-written email personalisation. Calls are authenticated with an API key (the price list works without one) and paid calls are billed per call from a prepaid wallet in GBP. All endpoints are under https://api.meirra.com/v1. Send the key as `Authorization: Bearer mk_live_…` or `x-api-key: mk_live_…`. Rate limit: 1000 requests per key per endpoint per hour. Errors are JSON with a stable `code` to branch on. ## Machine-readable - [OpenAPI 3.1 (JSON)](https://api.meirra.com/openapi.json): Every /v1 endpoint, generated from the routes' own schemas. - [OpenAPI (YAML)](https://www.meirra.com/openapi.yaml): The OpenAPI description published on the website. - [Authentication for agents (auth.md)](https://api.meirra.com/auth.md): How a key is created and sent, its limits and the auth error codes. - [Public pricing (JSON)](https://api.meirra.com/v1/pricing): Every endpoint's GBP price per call; works without an API key. - [API catalog](https://api.meirra.com/.well-known/api-catalog): RFC 9727 catalog linking the API's description, documentation and status. - [Versioning and deprecation policy](https://api.meirra.com/versioning.md): The version is in the URL; how a deprecation is announced (Deprecation and Sunset headers). ## Documentation - [Developer portal](https://www.meirra.com/developers): Sign-up, API keys, quickstart and the OpenAPI spec. - [API guides](https://www.meirra.com/help/api): Guides for every endpoint family. - [Errors](https://www.meirra.com/help/api/errors): Every error code and how to fix it. - [API pricing](https://www.meirra.com/pricing/api): The per-endpoint rate card. - [Meirra llms.txt](https://www.meirra.com/llms.txt): The full site index: products, services, API and resources. - [Meirra llms-full.txt](https://www.meirra.com/llms-full.txt): Long-form product, API, billing and list-price facts in one file. ## Paying for the API (for agents) An agent does not pay Meirra directly and cannot sign up or add credit by itself. A person with a Meirra account holds a prepaid API wallet in GBP, creates an API key for the agent and tops the wallet up; each paid call the agent makes is debited from that wallet. No subscription is needed. 1. Get a key: the account owner creates a named API key on the developer dashboard (https://account.meirra.com/developers) and gives it to the agent through a secret store or environment variable. The key is shown once. Step by step: https://api.meirra.com/auth.md. 2. Check prices: `GET https://api.meirra.com/v1/pricing` returns every endpoint's per-call price in GBP as JSON and needs no key. Rate card for people: https://www.meirra.com/pricing/api. 3. Call and pay per call: a successful paid call is debited from the wallet and carries `X-Cost-Pence` (the pence debited) and `X-Balance-Remaining` (the balance in GBP). `GET https://api.meirra.com/v1/account/balance` is free and returns the balance. 4. Fair billing: errors are never charged, and a call that finds zero results is not charged (it returns `X-Cost-Pence: 0`). An AI batch (`/v1/ai/hook/batch`, `/v1/ai/subject/batch`) also returns `X-Cost-Pence: 0` when created; the wallet is then debited once per successful lead as the batch runs. If the balance is too low the call is refused before it runs with 402 `INSUFFICIENT_BALANCE`; nothing is charged. 5. Top up: the account owner adds credit on the developer dashboard (https://account.meirra.com/developers) and pays by card on a Stripe-hosted checkout page. Packs, in GBP: £15 adds £20 of credit; £38 adds £50 of credit; £75 adds £100 of credit; £151 adds £200 of credit; £377 adds £500 of credit. The checkout page shows the total, including any payment processing fee, before payment. An agent cannot top up by itself; when it gets `INSUFFICIENT_BALANCE` it should ask the account owner to add credit. 6. Who is paid: Meirra. Its Stripe business profile is @meirra (https://stripe.com/@meirra, network ID profile_61VkTY2Q5M6ael5bAA6VkTY23OE9c3XRikaalmBVwABk). - [Authentication for agents (auth.md)](https://api.meirra.com/auth.md): How the account owner creates a key and how an agent sends it. - [Public pricing (JSON)](https://api.meirra.com/v1/pricing): Every endpoint's GBP price per call; works without an API key. - [API billing guide](https://www.meirra.com/help/api/billing): Credits, charges and zero-result fairness.