API Pricing
Developer plan pricing, volume tiers, and how billing works for the BeeL. API.
Access to the BeeL. API is available with the Developer Plan. It includes everything in the Pro plan plus full API access, webhooks, sandbox environment, and idempotency support.
How Billing Works
Only issued invoices in production count. Drafts, sandbox invoices, and deleted invoices don't count towards your monthly limit. The counter resets on the 1st of each month.
Your bill depends on two things:
- Base plan — The Developer plan starts at 19,90€/month (or 15,90€/month billed annually)
- Volume tier — Choose a tier based on how many invoices you emit per month via the API in production
Sandbox invoices are completely free and unlimited — test as much as you need.
Volume Tiers
All prices exclude VAT. Annual billing saves ~20%.
| Invoices/month | Monthly | Annual (per month) | Annual total |
|---|---|---|---|
| 50 | 19,90€ | 15,90€ | 190,80€ |
| 250 | 32,90€ | 24,90€ | 298,80€ |
| 1.000 | 64,90€ | 49,90€ | 598,80€ |
| 2.500 | 109,90€ | 79,90€ | 958,80€ |
| 5.000 | 164,90€ | 129,90€ | 1.558,80€ |
Need more than 5.000 invoices/month? Contact us at it@beel.es for custom Enterprise pricing.
What counts as an invoice?
- ✅ Counts: Any invoice emitted in the production environment — standard, corrective, simplified, recurring
- ❌ Doesn't count: Draft invoices, sandbox invoices
- The limit resets on the 1st of each month
- If you exceed your tier, you'll be prompted to upgrade before emitting new invoices
Free Trial
Start with a 7-day free trial. Credit card required — you won't be charged until the trial ends.
- Production: Up to 20 invoices during the trial period
- Sandbox: Unlimited invoices — test as much as you need
- Full API access, all webhooks and features enabled
- Cancel anytime during the trial — no charge
What's Included
All Developer Plan tiers include:
API & Integration
- Full REST API — Complete programmatic access to invoices, customers, products, series, and tax configuration
- Webhooks — Real-time notifications for invoice events and VeriFactu status updates
- Sandbox environment — Isolated test environment with no fiscal effects
- Idempotency support — Safe request retries with
Idempotency-Keyheader - OpenAPI 3.0 specification — Auto-generate clients in any language
- Official SDKs — Node.js, Java, and Python
Invoicing Features (everything in Pro)
- Electronic invoicing — VeriFactu compliance with AEAT
- Professional PDFs — Automatic generation with customizable templates
- Email delivery — Send invoices directly to customers
- Multiple invoice series — Organize invoices by type or client
- Recurring invoices — Schedule automatic invoice generation
- Scheduled invoices — Set future emission dates
- Corrective invoices — Handle refunds and corrections
Data & Support
- Unlimited customers and products
- NIF/CIF validation — Automatic Spanish tax ID verification
- Bulk imports — CSV upload and Holded migration
- Priority email support — it@beel.es
Rate Limits
API requests are rate-limited per API key:
| Limit Type | Endpoints | Rate |
|---|---|---|
| STRICT | Auth, forms, sensitive operations | 5 requests/minute |
| STANDARD | CRUD, bulk operations, file uploads | 100 requests/minute |
| GLOBAL | All /api/* routes (fallback) | 1.000 requests/minute |
See the Rate Limits guide for response headers and best practices. Need higher limits? Contact us at it@beel.es.
Webhooks
Webhooks are included in all Developer Plan tiers at no additional cost.
Available events:
invoice.emitted— Invoice created and finalizedinvoice.email.sent— Invoice sent by emailinvoice.cancelled— Invoice cancelledverifactu.status.updated— VeriFactu registration accepted/rejected by AEAT
See the Webhooks documentation for setup and payload details.
Enterprise
Need more than 5.000 invoices/month? We offer:
- Custom pricing based on volume
- Multi-NIF support — Manage multiple business profiles from one account
- Dedicated support with SLA guarantees
- Custom integrations and development
Contact us at it@beel.es to discuss your needs.
Next Steps
- Start free trial — 7 days free
- Set up authentication — Get your API key
- Explore the SDKs — Node.js, Java, and Python
- Set up webhooks — Get real-time notifications
Questions? Email us at it@beel.es.