Is there a test environment for the API?

Yes. The test environment is enabled by using an API key with the beel_sk_test_ prefix. The base URL is the same as production (https://app.beel.es/api/v1), so you can test the full functionality without emitting real invoices or sending anything to the Spanish tax authority.

Are invoices created via API Verifactu-compliant?

Yes, automatically. When you issue an invoice from a Spanish-registered account, BeeL. registers it with the Spanish tax authority (AEAT), generates the official QR code, and notifies you of the status (accepted/rejected) via the verifactu.status.updated webhook. No flags needed in the request body.

Which official SDKs are available?

Node.js / TypeScript is already available. Java and Python are coming soon. In the meantime, you can integrate from any language via direct REST using the OpenAPI 3.0 spec published at docs.beel.es.

How do I authenticate against the API?

Use the Authorization: Bearer header followed by your API key. For example: Authorization: Bearer beel_sk_live_... in production, or beel_sk_test_... in test mode.

Which webhook events does BeeL. expose?

Four official events: invoice.emitted (invoice created and finalized), invoice.email.sent (invoice sent by email), invoice.cancelled (invoice cancelled), and verifactu.status.updated (Verifactu status accepted/rejected by AEAT).

What are the rate limits?

Limits are per-endpoint: NIF validation 100 req/h (with API key), CSV imports 3/h (max 1,000 records), Holded imports 5/h (max 5,000 records), bulk operations up to 50 invoices per request, and up to 10 active webhooks per account.

Does it integrate with Stripe?

Yes. Connect your Stripe account in the dashboard and BeeL. automatically emits a Verifactu-compliant invoice on every charge, subscription, or renewal. You can also do it via API by creating the invoice manually on Stripe webhook events.

Can I migrate my customers from Holded?

Yes. There is a direct import endpoint from Holded that accepts up to 5,000 records per file and 5 imports per hour. You don't need to write any migration code.

How does API pricing work?

Pricing is based on the monthly volume of invoices emitted. Plans range from 50 invoices/month to 5,000. Annual billing offers ~20% off monthly pricing. There is no per-call cost — only emitted invoices count, not test invoices or other endpoints.

What support do I get as a developer?

Full docs at docs.beel.es, downloadable OpenAPI 3.0 spec, examples for cURL/Node/Python, and email support with SLA for paid accounts.

REST API · OpenAPI 3.0

The most complete invoicing API for Spain

Verifactu, recurring subscriptions, multi-company, and real-time notifications — all in one API.

7 days free · no card · Test mode included

Node.js

import { BeeL } from '@beel_es/sdk';

const beel = new BeeL({ apiKey: process.env.BEEL_API_KEY! });

// Create a draft invoice
const invoice = await beel.invoices.create({
  type: 'STANDARD',
  recipient: { customer_id: '550e8400-e29b-41d4-a716-446655440000' },
  lines: [
    { description: 'Monthly subscription', quantity: 1, unit_price: 29.00, discount_percentage: 0 },
  ],
});

// Issue it to assign an invoice number and trigger VeriFactu
const issued = await beel.invoices.issue(invoice.id);
console.log(issued.invoice_number); // e.g. "A-2026/0001"

Everything it does

Everything your business needs to invoice in Spain

Much more than creating invoices: full coverage of what every Spanish business does every month. From recurring subscriptions to credit notes — no coming-soon features.

Verifactu without certificates

Auto-registered with the tax authority including official QR. Credit notes included. We handle the digital certificate.

Recurring subscriptions

Create a template and BeeL. issues every month. Pause, resume or skip periods hands-free.

Scheduled invoices

Schedule future emissions as draft or sent. Change the date or mark as paid anytime.

Painless migration

Upload your CSV or Excel and review a preview with errors and duplicates before importing.

Bulk operations

Create, edit or delete in batch with a single atomic request. Simulate before executing.

Many companies, one account

Each company with its own NIF and independent access. Ideal for accounting firms, agencies and marketplaces.

All Spanish tax regimes

VAT, IGIC, IPSI, IRPF and equivalence surcharge configured. No tax regime learning required.

Real-time webhooks

Signed notifications with automatic retries on every invoice status change.

PDFs, Excel and emails

Download, export or email invoices in one call. Drafts include a watermark.

Code-first

An invoice in a few lines

The same REST endpoint works from any stack. Copy-paste into sandbox with the beel_sk_test_ prefix.

cURL

curl -X POST https://app.beel.es/api/v1/invoices \
  -H "Authorization: Bearer beel_sk_test_a1b2c3d4e5f6g7h8" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "STANDARD",
    "recipient": { "customer_id": "550e8400-e29b-41d4-a716-446655440000" },
    "lines": [
      {
        "description": "Monthly subscription",
        "quantity": 1,
        "unit_price": 29.00,
        "discount_percentage": 0
      }
    ]
  }'

Examples use a test API key — safe to run without affecting production.

Your use case is already covered

Ready-made architectures for SaaS, marketplaces, ERP, agencies, developer tools and custom apps. Or jump into the official SDKs.

Transparent pricing, no surprises

You pay only for invoices emitted in production. Sandbox is unlimited and free.

starter

15,90€/month

or 19,90€/month billed monthly

50 invoices/month

growth

24,90€/month

or 32,90€/month billed monthly

250 invoices/month

pro

49,90€/month

or 64,90€/month billed monthly

1,000 invoices/month

scale

79,90€/month

or 109,90€/month billed monthly

2,500 invoices/month

enterprise

129,90€/month

or 164,90€/month billed monthly

5,000 invoices/month

Prices billed annually. Save ≈ 20% vs paying monthly. By subscribing you accept the Terms and Conditions, including the API terms of use.

Frequently asked questions

Start invoicing from your code today

Free test mode. Flip to production when you're ready.

7 days free · no card · Email support

import { BeeL } from '@beel_es/sdk'; const beel = new BeeL({ apiKey: process.env.BEEL_API_KEY! }); // Create a draft invoice const invoice = await beel.invoices.create({ type: 'STANDARD', recipient: { customer_id: '550e8400-e29b-41d4-a716-446655440000' }, lines: [ { description: 'Monthly subscription', quantity: 1, unit_price: 29.00, discount_percentage: 0 }, ], }); // Issue it to assign an invoice number and trigger VeriFactu const issued = await beel.invoices.issue(invoice.id); console.log(issued.invoice_number); // e.g. "A-2026/0001"

curl -X POST https://app.beel.es/api/v1/invoices \ -H "Authorization: Bearer beel_sk_test_a1b2c3d4e5f6g7h8" \ -H "Content-Type: application/json" \ -d '{ "type": "STANDARD", "recipient": { "customer_id": "550e8400-e29b-41d4-a716-446655440000" }, "lines": [ { "description": "Monthly subscription", "quantity": 1, "unit_price": 29.00, "discount_percentage": 0 } ] }'