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

# Search bills

`GET /v1/Bills`

Search for one or more bills.

## Query parameters

- `search.bill_id` integer[]
- `search.parent_bill_id` integer[]
- `search.bill_type` string[]
- `search.customer_id` integer[]
- `search.due_date_start` string, date-time
- `search.due_date_end` string, date-time
- `search.created_date_start` string, date-time
- `search.created_date_end` string, date-time
- `search.print_queue_flag` boolean
- `search.ebpp_queue_flag` boolean
- `search.ebpp_sent_date_start` string, date-time
- `search.ebpp_sent_date_end` string, date-time
- `search.isLive` boolean
- `search.cycle_date_start` string, date-time
- `search.cycle_date_end` string, date-time
- `search.print_profile_id` integer[]
- `search.page_size` integer
- `search.page` integer
- `search.sort` string

## Response `200`

OK

- RevWebAPIModelsGetOrSearchOfRevAppSearchModelsResponseOfRevAppModelsBill
  - `ok` boolean
  - `has_more` boolean — Helper for pagination. Indicates there are more records returned.
  - `record_count` integer — Total number of records found by the search.
  - `records` RevAppModelsBill[] — List of records returned.
    - `bill_id` integer — Primary identifier for this bill.
    - `parent_bill_id` integer — Parent id for this child account's bill.
    - `bill_type` 'NORMAL' | 'CHILD' | 'PARENT' — Bill type (i.e. NORMAL, CHILD, PARENT).
    - `print_batch_id` integer — ID print batch the bill was created in.
    - `customer_id` integer — ID of customer account on bill.
    - `due_date` string, date-time — Due date of the bill.
    - `created_date` string, date-time — Date the bill was created.
    - `amount_due` number, double — Total amount due at the time of bill creation.
    - `invoice_amount` number, double — Total amount of charges on the bill.
    - `credit_memo_amount` number, double — Total amount of credits on the bill.
    - `print_queue_flag` boolean — Indicates if bill is ready to be added to the print queue.
    - `printed_date` string, date-time — Date the bill was printed.
    - `generate_downloads` boolean — Indicates bill generates associated CDR downloads.
    - `late_fee_applied_flag` boolean
    - `first_month_flag` boolean
    - `ebpp_queue_flag` boolean — Indicates if bill needs to be added to email queue.
    - `ebpp_sent_date` string, date-time — Date the bill was sent to customer.
    - `itemize_local` boolean — Indicates if bill should include local calls.
    - `is_final_bill` boolean — Indicates if this bill is final.
    - `note` string — Remarks or comments associated with bill.
    - `bill_print_type_id` integer
    - `isLive` boolean — Indicates if bill is ready to be shown on BillCenter.
    - `cycle_date` string, date-time — Cycle date the bill was created for.
    - `pdf_only_flag` boolean — Indicates that the bill should create a PDF but not be printed.
    - `print_profile_id` integer — ID of print profile used on bill.
    - `ready_for_pdf_flag` boolean — Indicates if bill is ready for PDF generation.
    - `bill_create_batch_id` integer — ID of bill creation batch.
    - `pdf_file_id` integer — Foreign key 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)