## List issued invoices (tenant:trade:sales:read)

`GET /api/trade/v1/invoices`

Module: Trade · operationId: `listInvoices` · Tag: Issued documents · Auth: access token (`Authorization: Bearer <accessToken>`)

The newest 100 transactions of type `INVOICE` in the snapshot shape.

### Responses

- **200** Invoices (`application/json`)
- **401** No valid session or bearer token (no body).

Fields of the 200 answer:

- `items` (array of IssuedInvoice, required)
  - `addressId` (string): Masterdata address of the customer.
  - `addressSnapshot` (AddressSnapshot): Frozen copy of the partner address (GoBD).
  - `articleSnapshots` (array of object): Lines as sent. Recognised keys: `articleNumber`, `name`, `description`, `quantity` (default 1), `unit`, `unitPriceNet` (or `price`), `discountPercent`, `taxRate`; the entry is kept as sent.
  - `createdAt` (string (date-time)): When the invoice was created.
  - `customerNo` (string): Customer number of the tenant.
  - `documentDate` (string (date)): Invoice date.
  - `eInvoiceValidation` (EInvoiceValidationSummary): The newest e-invoice check of the invoice (details: `getInvoiceValidation`). Missing without e-invoice.
    - `createdAt` (string (date-time)): When the check ran.
    - `errorCount` (integer): Number of errors.
    - `id` (string (uuid)): Id of the e-invoice check.
    - `valid` (boolean): The document passed the check (no errors).
    - `warningCount` (integer): Number of warnings.
  - `grossTotal` (number): Gross total of the invoice.
  - `id` (string (uuid)): Id of the invoice.
  - `invoiceNumber` (string): Number of the invoice.
  - `netTotal` (number): Net total of the invoice.
  - `numberPending` (boolean): A draft another module made: `invoiceNumber` is its id until `releaseTransaction` numbers it.
  - `partnerName` (string): The customer as the document names it (recipient name, else the name of the address snapshot)
  - `status` (string): Status of the invoice.
  - `tenantName` (string): Name of the tenant.
  - `updatedAt` (string (date-time)): When the invoice was last changed.

Example 200 answer:

```json
{
  "items": [
    {
      "addressId": "3c5e7a91-2b4d-4f6a-8c1e-5d7f9a0b1c02",
      "addressSnapshot": {
        "city": "Regensburg",
        "companyName": "Kanzlei Hofmann \u0026 Partner Rechtsanwälte mbB",
        "country": "DE",
        "street": "Maximilianstraße 21",
        "zip": "93047"
      },
      "articleSnapshots": [
        {
          "articleNumber": "WART-STD",
          "name": "IT-Wartung Standard November 2026",
          "quantity": 1,
          "taxRate": 19,
          "unit": "MON",
          "unitPriceNet": 490
        }
      ],
      "createdAt": "2026-11-03T06:00:00Z",
      "customerNo": "99999",
      "documentDate": "2026-11-03",
      "eInvoiceValidation": {
        "createdAt": "2026-11-03T06:00:01Z",
        "errorCount": 0,
        "id": "7c0d1e2f-3a4b-4c5d-8e6f-8a9b0c1d2e03",
        "valid": true,
        "warningCount": 0
      },
      "grossTotal": 583.1,
      "id": "6d9e0f1a-2b3c-4d4e-8f5a-7b8c9d0e1f01",
      "invoiceNumber": "RE-2026-1042",
      "netTotal": 490,
      "numberPending": false,
      "partnerName": "Kanzlei Hofmann \u0026 Partner Rechtsanwälte mbB",
      "status": "issued",
      "tenantName": "DEMO",
      "updatedAt": "2026-11-03T06:00:00Z"
    }
  ]
}
```

### Example request

```bash
curl -X GET 'https://api.mbcom.cloud/api/trade/v1/invoices' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
