Introduction
The Getbeel REST API and MCP server for Italian e-invoicing.
Getbeel lets you create, validate and send Italian e-invoices (FatturaPA) to SDI, read issued and received invoices, and follow every SDI receipt with webhooks. The same operations are available as MCP tools for AI agents.
How it works
- REST and JSON. Fields in
snake_case, ISO 8601 dates, amounts as decimal strings ("122.00") to avoid rounding errors. - Italian tax terms stay in Italian:
codice_destinatario,tipo_documento,natura,regime_fiscale. Everything else is English. - Test and live keys.
gb_test_…keys use the sandbox, which simulates SDI;gb_live_…keys transmit for real. The endpoints are the same. - One API, one MCP server. The MCP server uses the same keys and services as the API.
Base URL
https://www.getbeel.com/api/v1Coming soon
The API will also be served at https://api.getbeel.com/v1. The current URL
will keep working.
What you can do today
| Endpoint | What it does |
|---|---|
GET /me | The account, company and key making the request |
GET /invoices | List issued invoices |
GET /invoices/{id} | One issued invoice, with its lines |
POST /invoices | Create a draft invoice |
POST /invoices/{id}/send | Send the draft to SDI (or to the sandbox with a test key) |
POST /invoices/validate | Check a FatturaPA XML without sending it |
GET /received-invoices | List supplier invoices |
Every detail, with the playground, is in the API reference. Webhooks are described in Webhooks.
Coming soon
Multiple companies (companies), invoices received through SDI on Getbeel's
codice destinatario, invoice PDF and XML downloads, contacts, bank
reconciliation, SDKs and a CLI. These docs are updated as they ship.