List available receipts of a sent document (SAPI+)
SAPI+ extension. Lists the stored receipts of a document submitted through POST /document/send - the transport-level AS4 receipt of the delivery exchange, the received MLS of the counterparty AP, and for the TDD branch the AS4 receipt and MLS of the TaxDataDocument reporting to C5. The list contains the public metadata only (no XML content); use the detail endpoint to download an artifact.
Negatively typed AS4 error responses stay internal for now - only a stored positive AS4 receipt is published. A receiptId is published only after the artifact content was stored, so a waiting state is visible as an empty list or an absent receiptId rather than a 409. Receipts are returned ordered by receivedAt ascending with receiptId as the secondary sort key; the cursor is bound to the authorized context and the used filters. An empty list is a 200 with receipts: [].
scope is the processing branch (DELIVERY | TAX_REPORTING), NOT an OAuth scope. reportId combined with scope=DELIVERY is rejected with 400 because a TDD report never belongs to the delivery branch; reportId without scope evaluates against the receipts of that specific TDD. A syntactically valid filter without any match returns an empty list.
curl -X GET "https://einvoice-v1-ynyiur6quq-ey.a.run.app/v1/sapi-plus/document/send/doc_a1b2c3d4e5f6g7h8/receipts?scope=DELIVERY&type=MLS&reportId=example_string&pageToken=example_string&limit=20" \
-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/receipts?scope=DELIVERY&type=MLS&reportId=example_string&pageToken=example_string&limit=20"
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/receipts?scope=DELIVERY&type=MLS&reportId=example_string&pageToken=example_string&limit=20", {
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/receipts?scope=DELIVERY&type=MLS&reportId=example_string&pageToken=example_string&limit=20", 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/receipts?scope=DELIVERY&type=MLS&reportId=example_string&pageToken=example_string&limit=20')
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
{
"receipts": [
{
"receiptId": "rcpt_c3_mls",
"providerDocumentId": "doc_123",
"scope": "DELIVERY",
"type": "MLS",
"transmissionId": "tx_789",
"receivedAt": "2026-10-27T10:00:10Z",
"responseCode": "AP",
"reportId": "tdd_456"
}
],
"nextPageToken": "example_string"
}
{
"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}/receiptsTarget 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 (providerDocumentId from POST /document/send).
Processing branch filter: DELIVERY (business document exchange) or TAX_REPORTING (SK TaxDataDocument reporting). Absent = both branches.
Artifact type filter: MLS (received Message Level Status) or AS4_RECEIPT (positive transport receipt). Absent = both types.
Filter on the receipts of one specific TDD report (reportId). Cannot be combined with scope=DELIVERY (400).
Opaque cursor token for the next page. Obtained from the nextPageToken field of a previous response. The client must pass it back unchanged.
Maximum number of receipts to return per page
Sender's Peppol Participant ID of the original document (organization context).
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 (providerDocumentId from POST /document/send).
doc_a1b2c3d4e5f6g7h8Query Parameters
Processing branch filter: DELIVERY (business document exchange) or TAX_REPORTING (SK TaxDataDocument reporting). Absent = both branches.
DELIVERYTAX_REPORTINGArtifact type filter: MLS (received Message Level Status) or AS4_RECEIPT (positive transport receipt). Absent = both types.
MLSAS4_RECEIPTFilter on the receipts of one specific TDD report (reportId). Cannot be combined with scope=DELIVERY (400).
Opaque cursor token for the next page. Obtained from the nextPageToken field of a previous response. The client must pass it back unchanged.
Maximum number of receipts to return per page
Headers
Sender's Peppol Participant ID of the original document (organization context).
0245:1234567890Responses
List of receipt metadata, ordered by receivedAt ascending with receiptId as the secondary key
Opaque cursor token for the next page. Absent when no more pages.