Skip to main content
GET
/
v1
/
receipt-types
List receipt types
curl --request GET \
  --url https://api.truthlocks.com/v1/receipt-types \
  --header 'X-API-Key: <api-key>'
{
  "items": [
    {
      "name": "<string>",
      "display_name": "<string>",
      "schema": {},
      "created_at": "<string>"
    }
  ]
}
Returns all receipt types available to the authenticated tenant. Includes all five platform-defined types (globally available to every tenant) plus any custom types registered by the tenant. Use this endpoint to discover available types and inspect the JSON Schema each type enforces on the payload field when minting a receipt.

Platform-defined types

NameDisplay NameUse Case
payment_receiptPayment ReceiptPayments, invoices, refunds
security_event_receiptSecurity Event ReceiptAuth events, key rotations, anomalies
delivery_receiptDelivery ReceiptDocument/credential/notification delivery
compliance_receiptCompliance ReceiptKYC, AML, sanctions checks
custom_receiptCustom ReceiptAny tenant-defined event (open schema)
Platform types have tenant_id: null in the response. Tenant-custom types include their tenant_id.

Responses

Authorizations

X-API-Key
string
header
required

API key for machine-to-machine authentication

Response

Receipt types list

items
object[]