Skip to main content

Search MLR history


Retrieve all MLR, Message Level Response, records previously sent for a company's incoming invoices.

Endpoint

PropertyValue
URLGET /peppol/search-mlr?companyId={{companyId}}
MethodGET
AuthR-Auth: <company-jwt>

Example Request

curl --location '{{baseUrl}}/peppol/search-mlr?companyId={{companyId}}' \
--header 'R-Auth: {{companyJwt}}'

Query parameters

ParameterTypeRequiredDescription
companyIdUUIDYesCompany UUID

Response

[
{
"id": "230644e0-9c27-4a00-87ca-ab1f6a14370c",
"companyId": "17f81c76-fd84-45e0-bd39-76d5c04c515f",
"documentId": "5429a127-578f-426c-afe1-e551d05ed3a9",
"responseType": "REJECTION",
"receivedTime": "2026-06-15T10:08:18",
"counterpartParticipantId": "iso6523-actorid-upis::0002:271688503",
"invoiceId": "02d03693-f4cd-4460-883c-adfdad130603",
"responseLines": [
{
"id": "62b0a495-7b7b-46b5-8001-4f94471d981e",
"errorField": "string",
"responseCode": "REJECTION",
"description": "Invoice amount does not match purchase order",
"statusReasonCode": "BUSINESS_RULE_VIOLATION_FATAL"
}
],
"note": null
}
]

Response fields

FieldDescription
idMLR record UUID
companyIdCompany UUID
documentIdRelated document UUID
responseTypeACCEPTANCE, ACKNOWLEDGING, or REJECTION
receivedTimeTimestamp when the MLR response was created or received
counterpartParticipantIdPeppol participant identifier of the counterpart
invoiceIdCorresponds to id in the Search documents response
responseLinesEmpty for ACCEPTANCE or ACKNOWLEDGING; contains error details for REJECTION
responseLines[].idResponse line UUID
responseLines[].errorFieldInvoice field related to the response line
responseLines[].responseCodeResponse code, usually REJECTION for error lines
responseLines[].descriptionHuman-readable error description
responseLines[].statusReasonCodeReason code, for example BUSINESS_RULE_VIOLATION_FATAL
noteOptional free-text note