API Pricing and Billing

How API billing works

API filings are included with your Portfolio subscription. There are no per-filing charges and no separate balance to maintain — your subscription covers everything.

Each Portfolio tier includes an annual API filing allowance:

Plan	API filings included per year
Portfolio 3	20
Portfolio 12	40
Portfolio 50	80
Portfolio 150	120
Portfolio 250	200

A "filing" is one accepted submission (CT600 or Companies House accounts). Rejected or failed submissions do not count against your allowance. Sandbox filings (using a test key) are always free and unlimited.

What happens when the allowance runs out?

If you use all your included filings, the API will return an `ALLOWANCE_EXCEEDED` error. To continue filing, upgrade to a higher Portfolio tier at /pricing.

Your filing counter resets when your subscription renews each year.

Monitoring your usage

In API responses: Every successful filing response includes a `usage` object:

```json { "success": true, "data": { "filing_id": "fil_abc123", "status": "submitted", "usage": { "filings_remaining": 12, "warning": null } } } ```

When you reach 80% of your allowance, the `warning` field changes to `"warning"`. At 95%, it becomes `"critical"`. You'll also receive an email alert at each threshold.

In the dashboard: Visit API Dashboard → Billing to see your current usage and remaining filings.

Which plans include API access?

API access is available on tiered Portfolio plans only (Portfolio 3, 12, 50, 150, 250). Solo plans and legacy unlimited plans do not include API access.

If you're on a legacy plan and want to use the API, switch to a tiered Portfolio plan at /pricing.

Do sandbox filings count?

No. Filings made with a test key (`tt_test_...`) are free, stateless, and do not count against your allowance. Use sandbox mode for development and testing.

FAQ

Q: Is there VAT on API filings? A: No separate VAT charge. API filings are included in your subscription, which already includes VAT.

Q: Do amendments count as filings? A: Yes. Each accepted submission (including amendments) uses one filing from your allowance.

Q: What if a filing is rejected — do I lose the credit? A: No. Rejected or failed filings are automatically released back to your allowance.

Q: Can I check my remaining filings via the API? A: Yes. Every filing response includes `usage.filings_remaining`. You can also check the billing page in your dashboard.