# Receipts

> Solarium docs. All requests are `POST https://api.trysolarium.com/graphql/` with `Authorization: Bearer <api key>` and a JSON body `{"query": ..., "variables": ...}`. Every query and mutation takes an `organizationId` (find it with `myOrganizations`). Index of all pages: https://trysolarium.com/llms.txt

Receipts are documentary evidence attached to transactions. In Solarium V2, receipts don't create transactions directly — instead, you attach a receipt image to an existing transaction using `attachReceiptToEvent` (see [Transactions](#transactions)).

Receipts can also arrive automatically via Gmail scanning or SMS/email intake addresses. These are matched to bank transactions automatically when possible, or appear as unmatched receipts for manual review.

The `listReceipts` query below returns all receipt records, including their OCR-extracted data, matching status, and linked transaction.

## List Receipts

Returns a paginated list of receipts with OCR data, vendor, amount, and linked transaction.

### Arguments

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `organizationId` | `UUID!` | Yes | Organization ID |
| `limit` | `Int` | No | Page size (default 25) |
| `offset` | `Int` | No | Number of records to skip |
| `search` | `String` | No | Filter by vendor name |
| `status` | `String` | No | Filter by status: draft, processed, reviewed, rejected |
| `source` | `String` | No | Filter by source: web_upload, email, sms, gmail, google_drive |

### Request

```graphql
query {
  listReceipts(
    organizationId: "a1b2c3d4-..."
    limit: 10
    status: "draft"
  ) {
    items {
      id
      vendorName
      amount
      receiptDate
      status
      source
      imageUrl
      event { id merchantName status }
    }
    totalCount
  }
}
```

### Response

```json
{
  "data": {
    "listReceipts": {
      "items": [
        {
          "id": "r1a2b3c4-...",
          "vendorName": "Tim Hortons",
          "amount": 8.45,
          "receiptDate": "2026-01-15",
          "status": "draft",
          "source": "gmail",
          "imageUrl": "https://s3.amazonaws.com/...",
          "event": {
            "id": "e5f6g7h8-...",
            "merchantName": "Tim Hortons",
            "status": "needs_review"
          }
        }
      ],
      "totalCount": 12
    }
  }
}
```