GetbeelDocs

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/v1

Coming soon

The API will also be served at https://api.getbeel.com/v1. The current URL will keep working.

What you can do today

EndpointWhat it does
GET /meThe account, company and key making the request
GET /invoicesList issued invoices
GET /invoices/{id}One issued invoice, with its lines
POST /invoicesCreate a draft invoice
POST /invoices/{id}/sendSend the draft to SDI (or to the sandbox with a test key)
POST /invoices/validateCheck a FatturaPA XML without sending it
GET /received-invoicesList 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.

Next steps

On this page