API v1
Receipts
Search and retrieve receipt metadata.
GET
/api/v1/receipts/searchreadsearch_receipts
Search receipts by file name or OCR text. Returns up to 50 results.
Parameters
| Name | Type | Description |
|---|---|---|
| q* | string | Search query |
Response
json
{ "data": [ … ], "meta": { "count": 3, "limit": 50 } }GET
/api/v1/receipts/{id}readget_receipt
Receipt metadata (not file bytes). Use session API to download files.
Parameters
| Name | Type | Description |
|---|---|---|
| id* | uuid | Receipt ID |
Response
json
{ "data": { "id": "…", "fileName": "invoice.pdf", "transactionId": null, … } }File upload
Receipt file upload uses the Clerk session API (POST /api/receipts/upload-url), not API tokens. Agents can search and link existing receipts.