---
title: "List receipts"
method: GET
path: "/v1/platform/businesses/{business_id}/receipts/"
tags: ["Receipts"]
---

# List receipts

`GET /v1/platform/businesses/{business_id}/receipts/`

## Request

- Base URL: `https://docs.thredfi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.thredfi.com/v1/platform/businesses/{business_id}/receipts/`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP basic
  - HTTP bearer
  - HTTP bearer

List all receipts for a business with filters for vendor, dates, amounts, payment method, and reconciliation status. Supports standardized pagination.

## Path parameters

- `business_id` string, required

## Query parameters

- `currency` string
- `is_reconciled` boolean
- `max_amount` integer
- `min_amount` integer
- `page` integer
- `page_size` integer
- `payment_method` string
- `receipt_date_end` string, date-time
- `receipt_date_start` string, date-time
- `receipt_number` string
- `search` string
- `sort` string
- `vendor_external_id` string
- `vendor_id` string

## Response `200`

- PaginatedReceiptList
  - `count` integer, required: Total number of items
  - `page_info` object, required
    - `total_count` integer, required: Total number of items (same as count)
    - `current_page` integer, required: Current page number (1-indexed)
    - `total_pages` integer, required: Total number of pages
    - `page_size` integer, required: Number of items per page
  - `results` Receipt[], required
    - `type` string, required
    - `id` string, uuid, required
    - `business_id` string, uuid, required
    - `external_id` string
    - `receipt_number` string
    - `receipt_date` string, date-time, required
    - `description` string
    - `payment_method` string
    - `metadata` unknown
    - `currency` string, required
    - `vendor` Vendor, required: Serializer for vendor objects returned by the vendors list endpoint
      - `type` string, required: Resource type (always 'VendorData')
      - `id` string, uuid, required: Unique vendor identifier
      - `external_id` string: Your unique identifier for this vendor (used for idempotency)
      - `individual_name` string: Vendor individual name (for sole traders/freelancers)
      - `company_name` string: Registered company name (for limited companies)
      - `email` string, email: Primary email address for vendor communications
      - `mobile_phone` string, required: Mobile phone number (E.164 format, e.g., +44 7700 900123)
      - `office_phone` string, required: Office phone number (E.164 format, e.g., +44 20 7946 0958)
      - `address_string` string, required: Full formatted address (read-only, auto-generated)
      - `memo` string, required: Internal notes or description for this vendor
      - `status` string, required: Vendor status (ACTIVE, INACTIVE, ARCHIVED, BLOCKED)
      - `transaction_tags` unknown[], required: List of tags for categorization
        - unknown
      - `documents` DocumentFileUrl[], required: All documents linked to this vendor with presigned URLs
        - `url` string, uri, required: Presigned URL for document download
        - `expires_in` integer, required: Seconds until URL expires
        - `document_id` string, uuid, required: Document UUID
        - `file_name` string, required: Original document filename
        - `file_size` integer, required: File size in bytes
        - `mime_type` string, required: MIME type of the document
    - `document` DocumentFileUrl, required: Serializer for document file URL with metadata.
      - `url` string, uri, required: Presigned URL for document download
      - `expires_in` integer, required: Seconds until URL expires
      - `document_id` string, uuid, required: Document UUID
      - `file_name` string, required: Original document filename
      - `file_size` integer, required: File size in bytes
      - `mime_type` string, required: MIME type of the document
    - `total_amount` integer, required: Total receipt amount in cents
    - `reconciled_bank_transactions` EntityReconciliationDetail[], required: Bank transactions this receipt is reconciled to
      - `payment_type` string
      - `bank_transaction_id` string, uuid, required
      - `bank_transaction_date` string, date-time, required
      - `bank_transaction_amount_cents` integer, required
      - `bank_transaction_direction` string, required
      - `reconciled_amount_cents` integer, required
      - `reconciliation_link_id` string, uuid, required
      - `reconciled_at` string, date-time, required
      - `currency` string, required
      - `bank_account_name` string
      - `notes` string
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

---

[API](https://skmtc.dev/thredfi/apis/thredfi-accounting-platform-api.md) - [All operations](https://skmtc.dev/thredfi/apis/thredfi-accounting-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/thredfi/apis/thredfi-accounting-platform-api/revisions/0c1918254db3?raw)