---
title: "Search charges"
method: GET
path: "/v1/Charges"
tags: ["Charges"]
---

# Search charges

`GET /v1/Charges`

Search for one or more charges.

## Query parameters

- `search.charge_id` integer[]
- `search.customer_id` integer[]
- `search.service_id` integer[]
- `search.bill_id` integer[]
- `search.product_id` integer[]
- `search.service_product_id` integer[]
- `search.created_date_start` string, date-time
- `search.created_date_end` string, date-time
- `search.page_size` integer
- `search.page` integer
- `search.sort` string

## Response `200`

OK

- RevWebAPIModelsGetOrSearchOfRevAppSearchModelsResponseOfRevAppModelsCharge
  - `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` RevAppModelsCharge[] — List of records returned.
    - `charge_id` integer — Primary identifier for this charge.
    - `product_id` integer — Id of product associated with this charge
    - `product_type_id` integer — Id of product type associated with this charge
    - `customer_id` integer, required — Id of customer associated with this charge
    - `bill_id` integer — ID of bill the charge is applied to.
    - `service_id` integer — Id of service associated with this charge
    - `service_product_id` integer — Id of service product associated with this charge
    - `is_tax_included` boolean, required — Is tax included in the amount of the charge
    - `tax_class_id` integer — Id of Tax related to charge
    - `description` string, required — Description of this charge
    - `amount` number, double — Total dollar amount including taxes and product amounts on charge.
    - `cost` number, double, required — Cost associated to this charge
    - `product_amount` number, double — Dollar amount of product on this charge.
    - `is_commission_exempted` boolean, required — Is commission exempted from this charge
    - `tax_amount` number, double — Tax amount on this charge.
    - `geocode` string — Location of the charge.
    - `proration` number, double — Quantity of proration associated to this charge
    - `created_date` string, date-time — Date the charge was created.
    - `created_by` integer — ID of user that created the charge.
    - `quantity` number, double, required — Units of product or product type on the transaction.
    - `rate` number, double, required — Rate of product associated to this transaction
    - `is_prorated` boolean, required — Is proration of transaction required
    - `start_date` string, date-time, required — Billing start date of product or product type associated to this transaction
    - `end_date` string, date-time, required — Billing end date of product or product type associated to this transaction
    - `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)