## List Charges

`v1.plans.list_charges(**kwargs) -> CursorPage<PlanListChargesResponse>`

**get** `/v1/planDetails/{plan_id}/charges`

Fetches a list of charges of a specific plan.

### Parameters

- **plan\_id:** `String`

- **limit:** `Integer`

  Max number of results that should be returned

- **next\_page:** `String`

  Cursor that indicates where the next page of results should start.

### Returns

- `class PlanListChargesResponse`

  - **id:** `String`

  - **charge\_type:** `:usage | :fixed | :composite | 2 more`

    - `:usage`

    - `:fixed`

    - `:composite`

    - `:minimum`

    - `:seat`

  - **credit\_type:** `CreditTypeData`

  - **custom\_fields:** `Hash[Symbol, String]`

  - **name:** `String`

  - **prices:** `Array[{ tier, value, collection_interval, 2 more}]`

    - **tier:** `Float`

      Used in pricing tiers.  Indicates at what metric value the price applies.

    - **value:** `Float`

    - **collection\_interval:** `Float`

    - **collection\_schedule:** `String`

    - **quantity:** `Float`

  - **product\_id:** `String`

  - **product\_name:** `String`

  - **quantity:** `Float`

  - **start\_period:** `Float`

    Used in price ramps.  Indicates how many billing periods pass before the charge applies.

  - **tier\_reset\_frequency:** `Float`

    Used in pricing tiers.  Indicates how often the tier resets. Default is 1 - the tier count resets every billing period.

  - **unit\_conversion:** `{ division_factor, rounding_behavior}`

    Specifies how quantities for usage based charges will be converted.

    - **division\_factor:** `Float`

      The conversion factor

    - **rounding\_behavior:** `:floor | :ceiling`

      Whether usage should be rounded down or up to the nearest whole number. If null, quantity will be rounded to 20 decimal places.

      - `:floor`

      - `:ceiling`

### Example

```ruby
require "metronome_sdk"

metronome = MetronomeSDK::Client.new(bearer_token: "My Bearer Token")

page = metronome.v1.plans.list_charges(plan_id: "d7abd0cd-4ae9-4db7-8676-e986a4ebd8dc")

puts(page)
```