SAPI+ (Sent Document Status & Receipts)Get the delivery status of a sent document (SAPI+)

Get the delivery status of a sent document (SAPI+)

SAPI+ extension. Returns the current status of the technical delivery of a document submitted through POST /document/send and, separately, the status of the related Slovak TaxDataDocument (TDD) reporting to the SK tax authority (C5).

The result is derived from the actually recorded exchange evidence (AS4 transport receipt, received MLS of the counterparty AP / C5) and is returned with HTTP 200 even when the document was rejected, the send failed or the TDD was refused - 4xx/5xx describe a problem with this GET call only. It never reports business-level approval, booking, payment or ERP processing outcomes.

providerDocumentId is the value returned as providerDocumentId by POST /document/send. The X-Peppol-Participant-Id header carries the Peppol participant of the ORIGINAL SENDER of the document; the client must hold the document:send scope for that participant and this is the organization context of the document and its receipts.

curl -X GET "https://einvoice-v1-ynyiur6quq-ey.a.run.app/v1/sapi-plus/document/send/doc_a1b2c3d4e5f6g7h8/status" \
  -H "Content-Type: application/json" \
  -H "X-Peppol-Participant-Id: 0245:1234567890" \
  -H "Authorization: Bearer YOUR_API_TOKEN (JWT)"
{
  "providerDocumentId": "doc_a1b2c3d4e5f6g7h8",
  "documentId": "INV-2026-0001",
  "receivedAt": "2026-10-27T10:00:00Z",
  "delivery": {
    "status": "DELIVERED_CONFIRMED",
    "transport": {
      "status": "ACKNOWLEDGED",
      "acknowledgedAt": "2026-10-27T10:00:03Z",
      "receiptId": "rcpt_c3_as4",
      "transmissionId": "tx_789",
      "nextRetryAt": "2024-12-25T10:00:00Z",
      "failure": {
        "code": "SEND_FAILED",
        "message": "Participant DNS name is not registered",
        "occurredAt": "2024-12-25T10:00:00Z"
      }
    },
    "mls": {
      "status": "RECEIVED",
      "responseCode": "AP",
      "issuedAt": "2026-10-27T10:00:08Z",
      "receivedAt": "2026-10-27T10:00:10Z",
      "receiptId": "rcpt_c3_mls",
      "description": "example_string",
      "reasons": [
        {
          "statusReasonCode": "FD",
          "description": "example_string",
          "location": "example_string"
        }
      ]
    },
    "failure": {
      "code": "SEND_FAILED",
      "message": "Participant DNS name is not registered",
      "occurredAt": "2024-12-25T10:00:00Z"
    }
  },
  "taxReporting": {
    "status": "ACCEPTED",
    "reportId": "tdd_456",
    "taxDataTypeCode": "S",
    "transport": {
      "status": "ACKNOWLEDGED",
      "acknowledgedAt": "2026-10-27T10:00:03Z",
      "receiptId": "rcpt_c3_as4",
      "transmissionId": "tx_789",
      "nextRetryAt": "2024-12-25T10:00:00Z",
      "failure": {
        "code": "SEND_FAILED",
        "message": "Participant DNS name is not registered",
        "occurredAt": "2024-12-25T10:00:00Z"
      }
    },
    "mls": {
      "status": "RECEIVED",
      "responseCode": "AP",
      "issuedAt": "2026-10-27T10:00:08Z",
      "receivedAt": "2026-10-27T10:00:10Z",
      "receiptId": "rcpt_c3_mls",
      "description": "example_string",
      "reasons": [
        {
          "statusReasonCode": "FD",
          "description": "example_string",
          "location": "example_string"
        }
      ]
    },
    "failure": {
      "code": "SEND_FAILED",
      "message": "Participant DNS name is not registered",
      "occurredAt": "2024-12-25T10:00:00Z"
    }
  },
  "updatedAt": "2026-10-27T10:00:10Z",
  "timestamp": "2026-10-27T10:05:00Z"
}
GET
/v1/sapi-plus/document/send/{providerDocumentId}/status
GET
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token (JWT)
Bearer Tokenstring
Required

Bearer token (JWT) - just enter the token, "Bearer" prefix will be added automatically

path
providerDocumentIdstring
Required

Access Point identifier of the original submission - the providerDocumentId returned by POST /document/send. It is NOT the invoice number nor the client metadata.documentId.

header
X-Peppol-Participant-Idstring
Required

Sender's Peppol Participant ID of the original document (organization context). Must match the participant the document was submitted for.

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token (JWT). Authentication token required.

Path Parameters

providerDocumentIdstring
Required

Access Point identifier of the original submission - the providerDocumentId returned by POST /document/send. It is NOT the invoice number nor the client metadata.documentId.

Example:
doc_a1b2c3d4e5f6g7h8

Headers

X-Peppol-Participant-Idstring
Required

Sender's Peppol Participant ID of the original document (organization context). Must match the participant the document was submitted for.

Example:
0245:1234567890

Responses

providerDocumentIdstring
Required

Access Point identifier of the original submission

documentIdstring

Client document identifier delivered with the submission (the invoice/credit-note number of the submitted document)

receivedAtstring

Time when the Access Point technically accepted the original submission

deliveryobject
Required

Delivery result of the original business document. status is the derived summary; transport and mls keep the recorded evidence the summary was derived from. The summary is never set contrary to the underlying evidence.

taxReportingobject
Required

Result of the current Slovak TaxDataDocument (TDD) reporting operation of this AP (C2 -> C5 exchange). Kept strictly separate from delivery: a delivered invoice with a refused TDD and an accepted TDD with a delivery problem are both representable.

updatedAtstring
Required

Last change of the represented state (maximum over the exchanges contributing to the result)

timestampstring
Required

Response generation time