List e-invoice checks (tenant:trade:sales:read)
GET /api/trade/v1/invoice-validations
Module: Trade · operationId: listInvoiceValidations · Tag: Issued documents · Auth: access token (Authorization: Bearer <accessToken>)
The newest check of each e-invoice, newest first: invoices issued through issueInvoice (source=issue)
and invoices booked in microtech (source=microtech, setting outbound.eInvoiceMicrotechCheck). Pages by keyset
(creation time, then id; nextCursor), total counts all matches.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
source |
query | string | (one of issue, microtech) |
|
status |
query | string | invalid: only checks with errors. (one of invalid) |
|
q |
query | string | Search in document number, file name and document type (case-insensitive substring). | |
limit |
query | integer | (default 50; max 200) |
|
cursor |
query | string | The nextCursor of the previous page; omit for the first page. A cursor of another list is 400 invalid. |
Responses
- 200 A page of checks and the number of all matching ones. (
application/json) - 400 Error (
application/json) - 401 No valid session or bearer token (no body).
Fields of the 200 answer:
items(array of EInvoiceValidation, required): The checks, newest first.createdAt(string (date-time)): When the check ran.customerNo(string): Customer number of the tenant.customizationId(string): Customization id (BT-24) of the e-invoice.dmsDocumentId(string): The checked file in DMS (empty when it was refused).documentNumber(string): Invoice or document number (Belegnummer).documentType(string): microtech transaction type, e.g. Rechnung I.engineVersion(string): Version of the validator.errorCount(integer): Number of errors.fileName(string): File name of the checked XML.findings(array of EInvoiceFinding): Findings of the validation.location(string): XPath of the element; for schema errors the element path with line and column.message(string): Message of the rule.ruleId(string): Rule of EN 16931 or XRechnung (e.g. BR-DE-15), a schema error code of the validator (e.g. cvc-complex-type.2.4.a: violates the XML schema; the rules did not run), generic-error (not well-formed XML), no-scenario (no validation scenario fits the document), processing-error or PROCESSING_ERROR (the validator could not process it), KOSIT-NOT-XML, TRADE-MALWARE, TRADE-UNREADABLE (a microtech e-invoice that could not be read or checked).severity(string): Severity of the finding (e.g.error,warning). (one oferror,warning,information)
id(string (uuid)): Id of the e-invoice check.invoiceId(string (uuid)): The issued invoice (source issue).mode(string): The tenant setting applied to an issued invoice. (one ofwarn,block, ``)rulesVersion(string): Version of the validation rules.scenario(string): KoSIT scenario the document was validated with.source(string): What was checked:issue(issued in trade) ormicrotech(synchronised from the ERP). (one ofissue,microtech)syntax(string): Syntax of the e-invoice (e.g. UBL, CII).tenantName(string): Name of the tenant.valid(boolean): The document passed the check (no errors).warningCount(integer): Number of warnings.
total(integer, required): Number of all checks matching the filters.nextCursor(string): Pass ascursorfor the next page; absent on the last one.
Example 200 answer:
{
"items": [
{
"createdAt": "2026-11-19T09:05:00Z",
"customerNo": "99999",
"customizationId": "urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0",
"dmsDocumentId": "6a7b8c9d-0e1f-4a2b-8c3d-4e5f6a7b8c01",
"documentNumber": "RE-2026-0398",
"engineVersion": "1.5.0",
"errorCount": 0,
"fileName": "RE-2026-0398.xml",
"findings": [
{
"location": "/rsm:CrossIndustryInvoice/rsm:ExchangedDocumentContext/ram:GuidelineSpecifiedDocumentContextParameter/ram:ID",
"message": "Das Element \"Specification identifier\" (BT-24) soll syntaktisch der Kennung des Standards XRechnung entsprechen.",
"ruleId": "BR-DE-21",
"severity": "warning"
}
],
"id": "7c0d1e2f-3a4b-4c5d-8e6f-8a9b0c1d2e01",
"invoiceId": "2f6b1d84-7c3e-4a5b-9e21-6a0c4d8b1e04",
"mode": "warn",
"rulesVersion": "xrechnung-3.0.2",
"scenario": "EN16931 XRechnung (CII)",
"source": "issue",
"syntax": "CII",
"tenantName": "DEMO",
"valid": true,
"warningCount": 1
},
{
"createdAt": "2026-11-12T22:15:00Z",
"customerNo": "99999",
"customizationId": "urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0",
"dmsDocumentId": "6a7b8c9d-0e1f-4a2b-8c3d-4e5f6a7b8c02",
"documentNumber": "RE-2026-0377",
"documentType": "Rechnung I",
"engineVersion": "1.5.0",
"errorCount": 1,
"fileName": "RE-2026-0377.xml",
"findings": [
{
"location": "/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeAgreement",
"message": "Das Element \"Buyer reference\" (BT-10) muss übermittelt werden.",
"ruleId": "BR-DE-15",
"severity": "error"
}
],
"id": "7c0d1e2f-3a4b-4c5d-8e6f-8a9b0c1d2e02",
"mode": "",
"rulesVersion": "xrechnung-3.0.2",
"scenario": "EN16931 XRechnung (CII)",
"source": "microtech",
"syntax": "CII",
"tenantName": "DEMO",
"valid": false,
"warningCount": 0
}
],
"total": 2
}
Example request
curl -X GET 'https://api.mbcom.cloud/api/trade/v1/invoice-validations' \
-H "Authorization: Bearer $ACCESS_TOKEN"