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:

  1. Base plan — The Developer plan starts at 19,90€/month (or 15,90€/month billed annually)
  2. 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/monthMonthlyAnnual (per month)Annual total
5019,90€15,90€190,80€
25032,90€24,90€298,80€
1.00064,90€49,90€598,80€
2.500109,90€79,90€958,80€
5.000164,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-Key header
  • OpenAPI 3.0 specification — Auto-generate clients in any language
  • Official SDKsNode.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 supportit@beel.es

Rate Limits

API requests are rate-limited per API key:

Limit TypeEndpointsRate
STRICTAuth, forms, sensitive operations5 requests/minute
STANDARDCRUD, bulk operations, file uploads100 requests/minute
GLOBALAll /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 finalized
  • invoice.email.sent — Invoice sent by email
  • invoice.cancelled — Invoice cancelled
  • verifactu.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

  1. Start free trial — 7 days free
  2. Set up authentication — Get your API key
  3. Explore the SDKs — Node.js, Java, and Python
  4. Set up webhooks — Get real-time notifications

Questions? Email us at it@beel.es.