Get receipt by transaction ID

curl --request GET \
  --url https://api.digitalreceiptprotocol.org/api/v1/transactions/{transactionId}/receipt

{
  "success": true,
  "data": {
    "version": "1.0",
    "receiptId": "550e8400-e29b-41d4-a716-446655440003",
    "keyId": "550e8400-e29b-41d4-a716-446655440000",
    "keyBundle": {
      "encryptedAesKey": "encrypted_aes_key_base64...",
      "keyId": "550e8400-e29b-41d4-a716-446655440000",
      "algorithm": "RSA-OAEP-256"
    },
    "ciphertext": "encrypted_receipt_ciphertext_base64...",
    "iv": "initialization_vector_base64...",
    "authTag": "auth_tag_base64...",
    "merchantId": "550e8400-e29b-41d4-a716-446655440004",
    "transactionId": "550e8400-e29b-41d4-a716-446655440005",
    "createdAt": "2025-12-15T12:35:00Z",
    "expiresAt": "2025-12-16T12:35:00Z",
    "isEscrowed": false,
    "escrowKeyId": null
  }
}

GET

api

transactions

{transactionId}

receipt

Get receipt by transaction ID

curl --request GET \
  --url https://api.digitalreceiptprotocol.org/api/v1/transactions/{transactionId}/receipt

{
  "success": true,
  "data": {
    "version": "1.0",
    "receiptId": "550e8400-e29b-41d4-a716-446655440003",
    "keyId": "550e8400-e29b-41d4-a716-446655440000",
    "keyBundle": {
      "encryptedAesKey": "encrypted_aes_key_base64...",
      "keyId": "550e8400-e29b-41d4-a716-446655440000",
      "algorithm": "RSA-OAEP-256"
    },
    "ciphertext": "encrypted_receipt_ciphertext_base64...",
    "iv": "initialization_vector_base64...",
    "authTag": "auth_tag_base64...",
    "merchantId": "550e8400-e29b-41d4-a716-446655440004",
    "transactionId": "550e8400-e29b-41d4-a716-446655440005",
    "createdAt": "2025-12-15T12:35:00Z",
    "expiresAt": "2025-12-16T12:35:00Z",
    "isEscrowed": false,
    "escrowKeyId": null
  }
}

Path Parameters

transactionId

string<uuid>

required

UUID of the transaction

Response

Receipt retrieved successfully

success

boolean

Example:

true

data

object

Show child attributes

data.version

string

Example:

"1.0"

data.receiptId

string<uuid>

Example:

"550e8400-e29b-41d4-a716-446655440003"

data.keyId

string<uuid>

Example:

"550e8400-e29b-41d4-a716-446655440000"

data.keyBundle

object

Show child attributes

data.keyBundle.encryptedAesKey

string

Base64-encoded RSA-encrypted AES key

Example:

"encrypted_aes_key_base64..."

data.keyBundle.keyId

string<uuid>

Example:

"550e8400-e29b-41d4-a716-446655440000"

data.keyBundle.algorithm

enum<string>

Available options:

RSA-OAEP-256

Example:

"RSA-OAEP-256"

data.ciphertext

string

Base64-encoded AES-GCM encrypted receipt

Example:

"encrypted_receipt_ciphertext_base64..."

data.iv

string

Base64-encoded initialization vector

Example:

"initialization_vector_base64..."

data.authTag

string

Base64-encoded GCM authentication tag

Example:

"auth_tag_base64..."

data.merchantId

string<uuid>

Example:

"550e8400-e29b-41d4-a716-446655440004"

data.transactionId

string<uuid>

Example:

"550e8400-e29b-41d4-a716-446655440005"

data.createdAt

string<date-time>

Example:

"2025-12-15T12:35:00Z"

data.expiresAt

string<date-time> | null

Example:

"2025-12-16T12:35:00Z"

data.isEscrowed

boolean

True if encrypted with escrow key (user not onboarded)

Example:

false

data.escrowKeyId

string<uuid> | null

Escrow key ID if isEscrowed is true

Example:

null

Store transaction with receipt

⌘I

Getting Started

Health

Onboarding

Keys

Receipts

Transactions

Get receipt by transaction ID

Path Parameters

Response