SolariumSolariumDocs
Browse The Docs

Docs/API Reference/Receipts

POST

List Receipts

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

Parameters

organizationIdUUID!required

Organization ID

limitInt

Page size (default 25)

offsetInt

Number of records to skip

searchString

Filter by vendor name

statusString

Filter by status: draft, processed, reviewed, rejected

sourceString

Filter by source: web_upload, email, sms, gmail, google_drive

Request
query {
  listReceipts(
    organizationId: "a1b2c3d4-..."
    limit: 10
    status: "draft"
  ) {
    items {
      id
      vendorName
      amount
      receiptDate
      status
      source
      imageUrl
      event { id merchantName status }
    }
    totalCount
  }
}
Response
{
  "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
    }
  }
}