# Tentary invoices

`GET https://api.tentary.com/v1/tentary-invoices`

Source: https://tentary.com/de/help/api/list-tentary-invoices/
Area: Auswertungen
MCP tool: `list_tentary_invoices`. Reads only. Changes nothing in the account.

---

The invoices of Tentary to the account owner for the plan and the transaction fees, newest first. These are expenses of the account owner.

Each invoice has its number, date, `status` (`paid`, `open` or `uncollectible`), `paid_at`, the billing period, net, VAT, gross, the invoice lines and `pdf_url`, the link to the invoice PDF.

- Draft and void invoices are left out.
- The monthly fee invoices before March 2025 are not in the list. They are only in the Tentary app.

For the transaction fee of one payment, see `tentary_fee` in [`GET /v1/reports/accounting`](https://tentary.com/de/help/api/get-accounting-report/).

## Authorization

`Authorization: Bearer <API key>`

A personal API key (tnt_...). Create it in the Tentary app on the page AI & API.

## Query parameters

- `from` (string, query): Only invoices created on or after this day (UTC). Limits: pattern ^[0-9]{4}-[0-9]{2}-[0-9]{2}$.
- `to` (string, query): Only invoices created on or before this day (UTC). Limits: pattern ^[0-9]{4}-[0-9]{2}-[0-9]{2}$.

## Response

- `invoices` (array of object): Newest first.
  - `number` (string): The invoice number.
  - `date` (string<date-time>): UTC, like 2026-01-31T14:05:00Z.
  - `status` (string): paid, open or uncollectible.
  - `paid_at` (string<date-time>, can be null): UTC, like 2026-01-31T14:05:00Z.
  - `period_start` (string<date>): Like 2026-01-31.
  - `period_end` (string<date>): Like 2026-01-31.
  - `currency` (string): Currency code, like EUR.
  - `net` (string, can be null): Decimal string, like "19.90".
  - `vat` (string, can be null): Decimal string, like "19.90".
  - `gross` (string): Decimal string, like "19.90".
  - `lines` (array of object): The first 10 lines.
    - `description` (string)
    - `amount` (string): Decimal string, like "19.90".
  - `more_lines` (boolean)
  - `pdf_url` (string<uri>, can be null): The invoice PDF.
- `more` (boolean): true = Stripe has more (older) invoices: ask for a shorter period with from and to.
- `admin_url` (string<uri>): The page in the Tentary app.

## Example request

```bash
curl "https://api.tentary.com/v1/tentary-invoices" \
  -H "Authorization: Bearer $TENTARY_API_KEY"
```

## Example response

```json
{
  "invoices": [
    {
      "number": "TENT-0042",
      "date": "2026-10-01T06:00:00Z",
      "status": "paid",
      "paid_at": "2026-10-01T07:00:00Z",
      "period_start": "2026-09-01",
      "period_end": "2026-10-01",
      "currency": "EUR",
      "net": "41.94",
      "vat": "7.97",
      "gross": "49.91",
      "lines": [
        {
          "description": "1 × Grow (at €39.00 / month)",
          "amount": "39.00"
        },
        {
          "description": "Transaction fees",
          "amount": "2.94"
        }
      ],
      "more_lines": false,
      "pdf_url": "https://pay.stripe.com/invoice/acct_1Demo/test_YWNjdF8xRGVtbw/pdf"
    }
  ],
  "more": false,
  "admin_url": "https://app.tentary.com/settings/invoices"
}
```