Pricing and credit

You pay from prepaid credit: a small base subscription, and a price per call on top. Prices are in euros, excluding VAT. Test keys never cost anything.

The price list

GET /v1/pricing needs no API key and lists what applies now:

curl https://api.accountcloud.io/v1/pricing

{
  "currency": "EUR",
  "vat_included": false,
  "base_subscription": {
    "operation": "account.subscription",
    "product": "platform",
    "name": "Base subscription",
    "description": null,
    "status": "live",
    "unit": "month",
    "asynchronous": false,
    "prices": [
      { "variant": null, "model": "per_unit_month", "price": null, "monthly_price": "9.00", "unit": "account", "tiers": [], "valid_from": "2026-11-01T00:00:00Z" }
    ]
  },
  "operations": [
    {
      "operation": "address.forms",
      "product": "address",
      "name": "Address forms per country",
      "description": null,
      "status": "live",
      "unit": "call",
      "asynchronous": false,
      "prices": [
        { "variant": null, "model": "per_call", "price": "0.0000", "monthly_price": null, "unit": null, "tiers": [], "valid_from": "2026-11-01T00:00:00Z" }
      ]
    }
  ],
  "generated_at": "2026-11-03T14:20:41Z"
}

• model is per_call, a price per call, or per_unit_month, a price per unit per month.
• A per_call price can have tiers on the monthly volume; price is then null.
• An operation can have several priced variants, such as data from our cache and live data from the source.
• status is live, or preview for an operation that is announced but not generally available. An operation without a price is not in the list.
• Prices change from a date (valid_from); the list shows the one that applies now.

The base subscription

• It starts with your first paid top-up. The start credit you get when we verify your company does not start it.
• It is charged per day: every night we take that day’s part of the monthly price from your credit. The days of a month add up to exactly the monthly price.
• When your credit does not cover a day, the subscription has 3 days of grace, which are not charged. Then it is paused: you get an e-mail and a subscription.paused webhook. Your next paid top-up resumes it. Pausing does not block calls; a call that your credit cannot cover gets 402 insufficient_credits.
• You can stop it in the portal (owner or billing role, with two-factor authentication). Today is still charged, nothing after that. From tomorrow live calls get 403 subscription_ended, and automatic top-up stops. Test keys keep working, and a new paid top-up starts a new subscription.

Per call

Before a live call runs, its price is reserved on your credit. When the call succeeds (a 2xx), the price is taken; any other answer releases the reservation, so an error, invalid input or a fault on our side costs nothing. Sending the same POST again with the same Idempotency-Key replays the first answer and is not charged twice.

Two refusals before a call runs:

• 402 insufficient_credits when the credit does not cover the price, with the price and your available credit;
• 429 monthly_cap_reached when the call would pass the key’s monthly spending cap.

What a call cost

Every answer to a request whose key was accepted says what it cost:

Header	What it is
AccountCloud-Charged	What this call cost, in euros, with at least four decimals: 0.0350. 0.0000 for a free call, an error or a test key.
AccountCloud-Balance	With a live key, after a charged call: the credit you have left, in euros. Not sent when nothing was charged.

HTTP/1.1 200 OK
AccountCloud-Charged: 0.0350
AccountCloud-Balance: 184.20
X-Request-Id: req_01jbxk3v6c9m2q8r4t5w7y0z1a

GET /v1/me gives your balance at any time. The portal shows the usage and costs per day, operation and key, and every movement of your credit.

Topping up

Top up in the portal, from €10 up to €10,000 at a time (your first top-up at most €500). You pay through Mollie; VAT is added where it applies, and each top-up gets an invoice. Automatic top-up tops up for you when the credit falls below an amount you choose. When a charge takes your credit below your alert threshold (€2 unless you set another), you get an e-mail and a credit.low_balance webhook.