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(orprice),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:invoiceNumberis its id untilreleaseTransactionnumbers 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:
{
"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
curl -X GET 'https://api.mbcom.cloud/api/trade/v1/invoices' \
-H "Authorization: Bearer $ACCESS_TOKEN"