# Receipts

Search and retrieve receipt metadata.

### `GET /api/v1/receipts/search`

Search receipts by file name or OCR text. Returns up to 50 results.

- operationId: `search_receipts`
- scope: `read`

**Parameters**

- `q` (string, required) — Search query

**Response**

```json
{ "data": [ … ], "meta": { "count": 3, "limit": 50 } }
```

### `GET /api/v1/receipts/{id}`

Receipt metadata (not file bytes). Use session API to download files.

- operationId: `get_receipt`
- scope: `read`

**Parameters**

- `id` (uuid, required) — 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.