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)"
import requests
import json
url = "https://einvoice-v1-ynyiur6quq-ey.a.run.app/v1/sapi-plus/document/send/doc_a1b2c3d4e5f6g7h8/status"
headers = {
"Content-Type": "application/json",
"X-Peppol-Participant-Id": "0245:1234567890",
"Authorization": "Bearer YOUR_API_TOKEN (JWT)"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://einvoice-v1-ynyiur6quq-ey.a.run.app/v1/sapi-plus/document/send/doc_a1b2c3d4e5f6g7h8/status", {
method: "GET",
headers: {
"Content-Type": "application/json",
"X-Peppol-Participant-Id": "0245:1234567890",
"Authorization": "Bearer YOUR_API_TOKEN (JWT)"
}
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://einvoice-v1-ynyiur6quq-ey.a.run.app/v1/sapi-plus/document/send/doc_a1b2c3d4e5f6g7h8/status", nil)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-Peppol-Participant-Id", "0245:1234567890")
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN (JWT)")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://einvoice-v1-ynyiur6quq-ey.a.run.app/v1/sapi-plus/document/send/doc_a1b2c3d4e5f6g7h8/status')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['X-Peppol-Participant-Id'] = '0245:1234567890'
request['Authorization'] = 'Bearer YOUR_API_TOKEN (JWT)'
response = http.request(request)
puts response.body
{
"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"
}
{
"error": {
"category": "VALIDATION",
"code": "SAPI-VAL-001",
"message": "Document payload is invalid",
"details": [
{
"field": "document.type",
"issue": "Unsupported value"
}
],
"retryable": false,
"correlation_id": "550e8400-e29b-41d4-a716-446655440000"
}
}
{
"error": {
"category": "VALIDATION",
"code": "SAPI-VAL-001",
"message": "Document payload is invalid",
"details": [
{
"field": "document.type",
"issue": "Unsupported value"
}
],
"retryable": false,
"correlation_id": "550e8400-e29b-41d4-a716-446655440000"
}
}
{
"error": {
"category": "VALIDATION",
"code": "SAPI-VAL-001",
"message": "Document payload is invalid",
"details": [
{
"field": "document.type",
"issue": "Unsupported value"
}
],
"retryable": false,
"correlation_id": "550e8400-e29b-41d4-a716-446655440000"
}
}
{
"error": {
"category": "VALIDATION",
"code": "SAPI-VAL-001",
"message": "Document payload is invalid",
"details": [
{
"field": "document.type",
"issue": "Unsupported value"
}
],
"retryable": false,
"correlation_id": "550e8400-e29b-41d4-a716-446655440000"
}
}
{
"error": {
"category": "VALIDATION",
"code": "SAPI-VAL-001",
"message": "Document payload is invalid",
"details": [
{
"field": "document.type",
"issue": "Unsupported value"
}
],
"retryable": false,
"correlation_id": "550e8400-e29b-41d4-a716-446655440000"
}
}
{
"error": {
"category": "VALIDATION",
"code": "SAPI-VAL-001",
"message": "Document payload is invalid",
"details": [
{
"field": "document.type",
"issue": "Unsupported value"
}
],
"retryable": false,
"correlation_id": "550e8400-e29b-41d4-a716-446655440000"
}
}
/v1/sapi-plus/document/send/{providerDocumentId}/statusTarget server for requests. Edit to use your own host.
Bearer token (JWT) - just enter the token, "Bearer" prefix will be added automatically
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.
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
Bearer token (JWT). Authentication token required.
Path Parameters
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.
doc_a1b2c3d4e5f6g7h8Headers
Sender's Peppol Participant ID of the original document (organization context). Must match the participant the document was submitted for.
0245:1234567890Responses
Access Point identifier of the original submission
Client document identifier delivered with the submission (the invoice/credit-note number of the submitted document)
Time when the Access Point technically accepted the original submission
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.
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.
Last change of the represented state (maximum over the exchanges contributing to the result)
Response generation time