SAPI+ (Sent Document Status & Receipts)Get or download a receipt of a sent document (SAPI+)

Get or download a receipt of a sent document (SAPI+)

SAPI+ extension. Returns one stored receipt of a document submitted through POST /document/send.

Default JSON representation (Accept: application/json, absent Accept, or /): metadata + payload + payloadFormat - the payload is the exact stored artifact content (UTF-8 XML string): the original UBL MLS XML (ApplicationResponse) for type=MLS, or the stored SOAP receipt for type=AS4_RECEIPT.

Direct download: Accept: application/xml returns the original MLS XML (type=MLS only), Accept: application/soap+xml returns the stored SOAP envelope of the AS4 receipt (type=AS4_RECEIPT only) with Content-Disposition attachment. The bytes are the original stored artifact - no reserialization, pretty-print or namespace normalization. Unsupported representation for the given receipt type returns 406; all error responses are JSON (send Accept: application/xml, application/json;q=0.1 to still receive a structured error).

curl -X GET "https://einvoice-v1-ynyiur6quq-ey.a.run.app/v1/sapi-plus/document/send/doc_a1b2c3d4e5f6g7h8/receipts/rcpt_c3_mls" \
  -H "Content-Type: application/json" \
  -H "X-Peppol-Participant-Id: 0245:1234567890" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN (JWT)"
{
  "metadata": {
    "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"
  },
  "payload": "example_string",
  "payloadFormat": "XML"
}
GET
/v1/sapi-plus/document/send/{providerDocumentId}/receipts/{receiptId}
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).

path
receiptIdstring
Required

Identifier of the stored receipt (from the status response or the receipts list). Opaque; reachable only within the authorized document context.

header
X-Peppol-Participant-Idstring
Required

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

header
Acceptstring

Negotiated representation: application/json (default), application/xml (original MLS XML, type=MLS only) or application/soap+xml (stored SOAP AS4 receipt, type=AS4_RECEIPT only).

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
receiptIdstring
Required

Identifier of the stored receipt (from the status response or the receipts list). Opaque; reachable only within the authorized document context.

Example:
rcpt_c3_mls

Headers

X-Peppol-Participant-Idstring
Required

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

Example:
0245:1234567890
Acceptstring

Negotiated representation: application/json (default), application/xml (original MLS XML, type=MLS only) or application/soap+xml (stored SOAP AS4 receipt, type=AS4_RECEIPT only).

Responses

metadataobject
Required

Public metadata of one stored receipt. receiptId is published only after the artifact content is stored.

payloadstring
Required

Original stored artifact content (UBL MLS ApplicationResponse XML for type=MLS, stored SOAP receipt for type=AS4_RECEIPT), unaltered

payloadFormatstring
Required

Format of the payload content

Allowed values:XML