Document types

GET returns data[]. Branch on documentType. This list is the released enum (OpenAPI 1.7.0).

Product-wise: start with a receipt or an invoice — they cover most Swiss AP paper. Architecturally each type is a discriminator with its own schema; UNKNOWN is still a successful extract.

Select a type on the left. Samples are illustrative, not fixtures.

INVOICEStart here

Invoice

Rechnung

A supplier bills you. Most common upload.

{
  "documentType": "INVOICE",
  "documentId": "01HXYZ987654321FEDCBA",
  "title": "Rechnung 2026-1042",
  "language": "DE",
  "documentDate": "2026-03-12",
  "stateOfInvoice": "OUTSTANDING",
  "dueDate": "2026-04-11",
  "identifications": [
    {
      "type": "INVOICE_NUMBER",
      "value": "2026-1042"
    }
  ],
  "sender": {
    "name": "Muster AG",
    "taxIds": [
      {
        "type": "UID",
        "value": "CHE-123.456.789"
      }
    ],
    "address": {
      "street": "Bahnhofstrasse",
      "streetNumber": "1",
      "zipCode": "8001",
      "city": "Zürich",
      "country": "CHE"
    }
  },
  "recipient": {
    "name": "Beispiel Treuhand GmbH"
  },
  "grossAmount": {
    "currency": "CHF",
    "value": 1076
  },
  "netAmount": {
    "currency": "CHF",
    "value": 1000
  },
  "payableAmount": {
    "currency": "CHF",
    "value": 1076
  }
}

UNKNOWN is a successful extraction that could not pick a type — do not retry the upload; send feedback or file a case with the documentId.

Not on the wire: PAY_SLIP, CONTRACT, WARRANTY_POLICY, CREDITCARD_STATEMENT. Card statements are CREDIT_CARD_STATEMENT.