SAPI+ (Sent Document Status & Receipts)List available receipts of a sent document (SAPI+)

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)"
{
  "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"
}
GET
/v1/sapi-plus/document/send/{providerDocumentId}/receipts
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 (providerDocumentId from POST /document/send).

query
scopestring

Processing branch filter: DELIVERY (business document exchange) or TAX_REPORTING (SK TaxDataDocument reporting). Absent = both branches.

Options: DELIVERY, TAX_REPORTING
query
typestring

Artifact type filter: MLS (received Message Level Status) or AS4_RECEIPT (positive transport receipt). Absent = both types.

Options: MLS, AS4_RECEIPT
query
reportIdstring

Filter on the receipts of one specific TDD report (reportId). Cannot be combined with scope=DELIVERY (400).

query
pageTokenstring

Opaque cursor token for the next page. Obtained from the nextPageToken field of a previous response. The client must pass it back unchanged.

query
limitinteger

Maximum number of receipts to return per page

Min: 1 • Max: 100
header
X-Peppol-Participant-Idstring
Required

Sender's Peppol Participant ID of the original document (organization context).

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 (providerDocumentId from POST /document/send).

Example:
doc_a1b2c3d4e5f6g7h8

Query Parameters

scopestring

Processing branch filter: DELIVERY (business document exchange) or TAX_REPORTING (SK TaxDataDocument reporting). Absent = both branches.

Allowed values:DELIVERYTAX_REPORTING
typestring

Artifact type filter: MLS (received Message Level Status) or AS4_RECEIPT (positive transport receipt). Absent = both types.

Allowed values:MLSAS4_RECEIPT
reportIdstring

Filter on the receipts of one specific TDD report (reportId). Cannot be combined with scope=DELIVERY (400).

pageTokenstring

Opaque cursor token for the next page. Obtained from the nextPageToken field of a previous response. The client must pass it back unchanged.

limitinteger

Maximum number of receipts to return per page

Headers

X-Peppol-Participant-Idstring
Required

Sender's Peppol Participant ID of the original document (organization context).

Example:
0245:1234567890

Responses

receiptsarray
Required

List of receipt metadata, ordered by receivedAt ascending with receiptId as the secondary key

nextPageTokenstring

Opaque cursor token for the next page. Absent when no more pages.