---
title: "Get bill information in ledger form"
method: GET
path: "/v1/Bills/ledger"
tags: ["Bills"]
---

# Get bill information in ledger form

`GET /v1/Bills/ledger`

Get the ledger view of bills for a single customer.

## Query parameters

- `params.customer_id` integer
- `params.page_size` integer
- `params.start_index` integer

## Response `200`

OK

- RevAppSearchModelsResponseOfRevAppModelsBillLedgerModel — Generic search response model.
  - `has_more` boolean — Helper for pagination. Indicates there are more records returned.
  - `record_count` integer — Total number of records found by the search.
  - `records` RevAppModelsBillLedgerModel[] — List of records returned.
    - `bill_id` integer — Primary identifier for this bill.
    - `customer_id` integer — Identifier for the customer account associated with this bill.
    - `remaining_balance` number, double — Remaining balance for this bill, including transactions not yet reported on a bill.
    - `previous_balance` number, double — Balance that carries over from the previous bill.
    - `total_payments` number, double — Total amount of payments reported on this bill. Note: This is not the amount of payment that has applied to this bill.
    - `total_credits` number, double — Total amount of credits reported on this bill. Note: This is not the amount of credit that has applied to this bill.
    - `total_charges` number, double — Total amount of charges reported on this bill.
    - `total_recurring_charges` number, double — Total amount of monthly recurring charges on this bill.
    - `total_usage_charges` number, double — Total amount of usage charges on this bill.
    - `total_onetime_charges` number, double — Total amount of one-time charges on this bill.
    - `total_surcharges` number, double — Total amount of surcharges on this bill. Surcharges here represent any charge with an FCC product type whose description contains the term "PICC" or "Access" (i.e. Network Access Charge).
    - `total_taxes` number, double — Total amount of taxes on this bill. Taxes here represent anything that was generated by your chosen tax provider and could include surcharges the provider calculates.
    - `total_new_charges` number, double — The total new amount of charge the bill reports has been added to the account. This is simply the total_charges plus the total_credits field values. Note: it does not include the total_payments field value.
    - `amount_due` number, double — The total amount due on the date expressed on this bill.
    - `created_date` string, date-time — The date this bill was created.
    - `due_date` string, date-time — The date any amount due is to be paid by.
    - `printed_date` string, date-time — The date this bill was printed for mailing.
    - `emailed_date` string, date-time — The date this bill was emailed to the address or addresses noted on the customer account.
    - `pdf_file_id` integer — Foreign identifier indicating the PDF file representing this bill.
    - `links` RevAppComponentsLink[]
      - `rel` string
      - `href` string

## Other responses

- `500` — InternalServerError

---

[API](https://skmtc.net/rev-io/apis/rev-io-api.md) · [All operations](https://skmtc.net/rev-io/apis/rev-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rev-io/rev-io-api/revisions/135571434f6c/schema)