List receipt types
curl --request GET \
--url https://api.truthlocks.com/v1/receipt-types \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.truthlocks.com/v1/receipt-types', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/receipt-types"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/receipt-types"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"items": [
{
"name": "<string>",
"display_name": "<string>",
"schema": {},
"created_at": "<string>"
}
]
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}Receipts
List receipt types
Returns all registered receipt types for the authenticated tenant.
GET
/
v1
/
receipt-types
List receipt types
curl --request GET \
--url https://api.truthlocks.com/v1/receipt-types \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.truthlocks.com/v1/receipt-types', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/receipt-types"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/receipt-types"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"items": [
{
"name": "<string>",
"display_name": "<string>",
"schema": {},
"created_at": "<string>"
}
]
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}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
Platform types have
payload field when minting a receipt.
Platform-defined types
| Name | Display Name | Use Case |
|---|---|---|
payment_receipt | Payment Receipt | Payments, invoices, refunds |
security_event_receipt | Security Event Receipt | Auth events, key rotations, anomalies |
delivery_receipt | Delivery Receipt | Document/credential/notification delivery |
compliance_receipt | Compliance Receipt | KYC, AML, sanctions checks |
custom_receipt | Custom Receipt | Any tenant-defined event (open schema) |
tenant_id: null in the response. Tenant-custom types include their tenant_id.

