MarminDeveloper Docs
BusinessesPartnersProduct Wiki

Get Peppol status logs

Retrieves the Peppol transmission status logs for an invoice. This shows you the complete journey of your invoice through the Peppol network.

Note: If Phase 2 is not included in your subscription, please contact Marmin support at support@marmin.ai.

See the right panel for request and response examples.

Path parameters
ParameterTypeRequiredDescription
idstring
Required
The UUID of the invoice. This is the unique identifier used for Peppol transmission.
What are Peppol status logs?

When you send an invoice through the Peppol network, the system tracks every step of its journey. Status logs show you:

  • When it was sent — Timestamp of when the invoice left your system

  • When it was received — Timestamp of when it arrived at the customer's Access Point

  • When it was delivered — Timestamp of when it was successfully delivered to the customer's system

  • Any errors — If something went wrong, you'll see error messages

  • Acceptance status — Whether the customer's system accepted or rejected the invoice

Response

Status code: 200 OK

Returns an array of Peppol status log entries. Each entry includes:

FieldTypeDescription
idstringUnique identifier for the log entry.
sent_message_idstring or nullPeppol message ID when sent.
document_uuidstringUUID of the invoice.
document_typestringDocument type (e.g. INVOICE).
sender_idstring or nullSender identifier.
receiver_idstring or nullReceiver identifier.
doc_type_idstring or nullDocument type identifier.
process_idstring or nullProcess identifier.
country_c1string or nullCountry code.
document_xmlstring or nullDocument XML when applicable.
messagestringHuman-readable status message.
timestampnumberUnix timestamp (milliseconds).
eventstringEvent type (e.g. DOCUMENT_CREATED, DOCUMENT_SUBMITTED, VALIDATION_SUCCESS).

See the right panel for complete response examples.

Understanding Peppol transmission
How Peppol transmission works

  1. Invoice creation — You create an invoice through the API

  2. Automatic conversion — The system converts your invoice to Peppol-compliant XML format (PINT AE Billing specification)

  3. Electronic address lookup — The system looks up your customer's Peppol electronic address from their business profile

  4. Submission — The invoice is submitted to the Peppol Access Point

  5. Network routing — The Peppol network routes the invoice to your customer's Access Point

  6. Delivery — The customer's system receives and processes the invoice

  7. Status updates — You receive status updates at each step

Requirements for Peppol transmission

  • Your business profile must be registered with Peppol (have an electronic address)

  • Your customer's business profile must be registered with Peppol

  • Both parties must be using the same Peppol Access Point or compatible ones

  • The invoice must be in Phase 2 (Peppol-enabled) status

Note: If Phase 2 is not included in your subscription, please contact Marmin support at support@marmin.ai.

Benefits

  • Automatic delivery — No need to email or print invoices

  • Real-time tracking — Know exactly when your invoice was delivered

  • Reduced errors — Automated processing reduces manual data entry errors

  • Faster payment — Customers receive invoices instantly, potentially speeding up payment

  • Compliance — Peppol-compliant invoices meet UAE e-invoicing requirements

Error responses
StatusDescription
401 UnauthorizedAuthentication required or invalid token.
403 ForbiddenUser not authorized to access this invoice.
404 Not FoundInvoice or Peppol status not found.
500 Internal Server ErrorAn error occurred while processing the request.
Next