---
title: "List billing history"
method: GET
path: "/billing/history"
tags: ["Billing"]
---

# List billing history

`GET /billing/history`

Paginated invoice history for the caller's organization with optional filters and sort.

## Query parameters

- `limit` integer — max items per page
- `offset` integer — pagination offset
- `search` string — free-text search across invoice number/description
- `billing_cycle` string — filter by billing cycle
- `sort_by` string — column to sort by
- `sort_order` string — asc or desc
- `status` string — invoice status filter (lowercase)
- `date_from` string — RFC3339 lower bound for invoice_date
- `date_to` string — RFC3339 upper bound for invoice_date (with date_from = an exact calendar month)
- `plan_name` string — filter by plan name
- `phone_id` string — filter to invoices for a dedicated phone

## Response `200`

OK

- BillingHistoryBillingHistoryResponse
  - `has_more` boolean, required
  - `items` BillingHistoryBillingHistoryItem[], nullable, required
    - `amount_cents` integer, required
    - `amount_dollars` number, double, required
    - `billing_cycle` string, required
    - `currency` string, required
    - `description` string, required
    - `due_date` string, date-time
    - `formatted_amount` string, required
    - `hosted_invoice_url` string
    - `id` string, required
    - `invoice_date` string, date-time, required
    - `invoice_number` string, required
    - `invoice_pdf_url` string
    - `paid_at` string, date-time
    - `plan_name` string, required
    - `status` string, required
  - `total_count` integer, required

## Other responses

- `default` — Error

---

[API](https://skmtc.dev/axilioai/apis/axilio-api-2.md) · [All operations](https://skmtc.dev/axilioai/apis/axilio-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/axilioai/axilio-api-2/revisions/d7ecf9466d6d/schema)