---
title: "Return the data for all Bills"
method: GET
path: "/bills.json"
tags: ["Bills"]
---

# Return the data for all Bills

`GET /bills.json`

Outlines the parameters, optional and required, used when requesting the data for all Bills

## Query parameters

- `bill_number` string
- `client_id` integer
- `created_since` string, date-time
- `currency_id` integer
- `custom_field_values` '=' | '<' | '>' | '<=' | '>='
- `due_after` string, date
- `due_at` string, date
- `due_before` string, date
- `fields` string
- `ids[]` integer
- `issued_after` string, date
- `issued_before` string, date
- `last_sent_end_date` string, date
- `last_sent_start_date` string, date
- `limit` integer
- `matter_id` integer
- `order` 'id(asc)' | 'id(desc)' | 'due_at(asc)' | 'due_at(desc)' | 'issued_at(asc)' | 'issued_at(desc)' | 'paid_at(asc)' | 'paid_at(desc)' | 'last_sent_at(asc)' | 'last_sent_at(desc)' | 'client_name(asc)' | 'client_name(desc)' | 'matter_display_number(asc)' | 'matter_display_number(desc)' | 'balance(asc)' | 'balance(desc)' | 'number(asc)' | 'number(desc)'
- `originating_attorney_id` integer
- `overdue_only` boolean
- `page_token` string
- `query` integer
- `responsible_attorney_id` integer
- `state` 'draft' | 'awaiting_approval' | 'awaiting_payment' | 'paid' | 'void' | 'deleted'
- `status` 'all' | 'overdue'
- `type` 'revenue' | 'trust'
- `updated_since` string, date-time

## Headers

- `X-API-VERSION` string

## Response `200`

Ok

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Too Many Requests

---

[API](https://skmtc.net/clio/apis/clio-api-documentation.md) · [All operations](https://skmtc.net/clio/apis/clio-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clio/clio-api-documentation/revisions/73791ddd1207/schema)