ConnectCloud Developers

Get an issued invoice (tenant:trade:sales:read)

GET /api/trade/v1/invoices/{id}

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

Parameters

Name In Type Required Description
id path string (uuid) yes

Responses

  • 200 Invoice (application/json)
  • 401 No valid session or bearer token (no body).
  • 404 No invoice with this id (also for transactions of another type). (application/json)

Fields of the 200 answer:

  • 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:

{
  "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/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

View as Markdown · Interactive reference · OpenAPI