---
title: "List bills"
method: GET
path: "/bills"
tags: ["Bills"]
---

# List bills

`GET /bills`

Get a paginated list of bills with optional filtering

## Query parameters

- `limit` integer
- `after` string
- `before` string
- `vendor_id` string
- `status` string
- `bill_number` string
- `source` string
- `include_deleted` boolean

## Response `200`

OK

- PaginatedResponseBillReply
  - `data` BillReply[]
    - `amount` number
    - `created_at` string
    - `description` string
    - `due_date` string
    - `id` string
    - `issue_date` string
    - `last_status` BillStatusReply — Bill status history entry
      - `created_at` string
      - `reason` string
      - `status` 'draft' | 'needs_approval' | 'processing' | 'paid' | 'deleted' | 'failed' — Bill status enum
      - `user_id` string
    - `line_items` LineItemReply[]
      - `description` string
      - `expense_account_id` string
      - `name` string
      - `quantity` number
      - `sequence` integer
      - `tax` number
      - `total` number
      - `unit_price` number
      - `unit_type` string
    - `number` string
    - `pay_date` string
    - `source` 'manual' | 'quickbooks' | 'ocr' — Bill source enum
    - `status` 'draft' | 'needs_approval' | 'processing' | 'paid' | 'deleted' | 'failed' — Bill status enum
    - `updated_at` string
    - `vendor_id` string
    - `vendor_payments` VendorPaymentReply[]
      - `attempt_number` integer
      - `estimated_arrival_date` string
      - `failure_reason` string
      - `hold_until` string
      - `id` string
      - `payment_method_id` string
      - `payment_speed` 'standard' | 'next_day' | 'same_day' | 'instant' — Payment speed enum
      - `sent_at` string
      - `status` 'hold' | 'waiting_pay_date' | 'ready' | 'processing' | 'succeeded' | 'failed' — Vendor payment status enum
  - `end_cursor` string
  - `has_next_page` boolean
  - `has_previous_page` boolean
  - `start_cursor` string

---

[API](https://skmtc.net/alternativepayments/apis/alternative-payments.md) · [All operations](https://skmtc.net/alternativepayments/apis/alternative-payments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alternativepayments/alternative-payments/revisions/730efda86cd1/schema)