Introduction

What is Beel?

Beel is an invoicing platform specifically designed for freelancers in Spain. The Beel API is a RESTful API that allows you to manage invoices, clients, and products with full VeriFactu compliance from a single interface.

What can you do with the API?

• Create and manage invoices (standard, corrective, and simplified)
• Manage clients and products with full CRUD operations
• VeriFactu compliance at no additional cost or complexity
• Generate professional PDFs for all your invoices
• Send invoices via email directly from the API
• Configure taxes and series with custom settings
• Validate NIF/CIF automatically
• Bulk import data from CSV or Holded

Base URL

All API requests use this base URL:

https://app.beel.es/api/v1

For example, to list invoices:

GET https://app.beel.es/api/v1/facturas

The base URL is the same for both sandbox and production. The environment is automatically determined by the API Key you use:

• Sandbox API Key: beel_sk_test_xxx → Test environment
• Production API Key: beel_sk_live_xxx → Production environment

Key Concepts

Before getting started, it's important to understand these fundamental concepts:

Invoices

These are the billing documents you issue. Beel supports three types:

• Standard (Ordinaria): Full-detail standard invoices
• Corrective (Rectificativa): To correct or void previous invoices
• Simplified (Simplificada): Simplified invoices for smaller transactions

Clients

The recipients of your invoices. You can manage them individually or import them in bulk from CSV or Holded.

Products

The services or products you invoice. They allow you to reuse common concepts in your invoices.

VeriFactu

Spanish Tax Agency's integrity and traceability system. Beel automatically handles compliance at no additional cost.

Invoice Series

Groupings that allow you to have different numbering sequences (e.g., "FACT-2024-001", "REC-2024-001").

Next Steps

Ready to get started?

1. Set up authentication — Get your API Key and learn how to authenticate requests
2. Check pricing — Information about the Pro Plan
3. Read the guides — Best practices and important concepts
4. Explore the endpoints — Discover all available operations