Skip to main content
GET
/
v1
/
receipts
List receipts
curl --request GET \
  --url https://api.truthlocks.com/v1/receipts \
  --header 'X-API-Key: <api-key>'
{
  "items": [
    {
      "receipt_id": "<string>",
      "receipt_type": "<string>",
      "status": "<string>",
      "subject": "<string>",
      "issued_at": "<string>"
    }
  ],
  "cursor": "<string>"
}
Returns a paginated list of receipt events for the authenticated tenant. Filter by type, status, or issuer.

​
Query parameters

​
receipt_type
string
Filter by receipt type name (e.g. payment_receipt).
​
issuer_id
string
Filter by issuer UUID.
​
status
string
Filter by status: active, revoked, or superseded.
​
limit
integer
Max results per page (1–100, default 20).
​
offset
integer
Pagination offset (default 0).

​
Response

​
items
array
Array of receipt objects.
​
total
integer
Total matching receipts.
​
limit
integer
Page size.
​
offset
integer
Current offset.

Authorizations

​
X-API-Key
string
header
required

API key for machine-to-machine authentication

Query Parameters

​
limit
integer
default:20

Maximum number of receipts to return

​
cursor
string

Pagination cursor

​
receipt_type
string

Filter by receipt type

​
status
enum<string>

Filter by status

Available options:
active,
revoked,
redacted

Response

Receipt list

​
items
object[]
​
cursor
string | null