# Introduction (https://docs.getbeel.com/en/api)

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 [#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](/en/api/sandbox), which simulates SDI; `gb_live_…` keys transmit for real. The endpoints are the same.
- **One API, one MCP server.** The [MCP server](/en/api/mcp) uses the same keys and services as the API.

## Base URL [#base-url]

```text
https://www.getbeel.com/api/v1
```

<Callout title="Coming soon">
  The API will also be served at `https://api.getbeel.com/v1`. The current URL
  will keep working.
</Callout>

## What you can do today [#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](/en/api/reference). Webhooks are described in [Webhooks](/en/api/webhooks).

<Callout title="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.
</Callout>

## Next steps [#next-steps]

<Cards>
  <Card
    title="Quickstart"
    href="/en/api/quickstart"
    description="First call and first sandbox invoice in a few minutes."
  />
  <Card
    title="Authentication"
    href="/en/api/authentication"
    description="Test and live keys, scopes, security."
  />
  <Card
    title="Sandbox"
    href="/en/api/sandbox"
    description="How to trigger every SDI outcome."
  />
  <Card
    title="MCP"
    href="/en/api/mcp"
    description="Connect Claude, ChatGPT or Cursor."
  />
</Cards>
