## List Costs

`v1.customers.list_costs(**kwargs) -> CursorPage<CustomerListCostsResponse>`

**get** `/v1/customers/{customer_id}/costs`

Fetch daily pending costs for the specified customer, broken down by credit type and line items. Note: this is not supported for customers whose plan includes a UNIQUE-type billable metric.

### Parameters

- **customer\_id:** `String`

- **ending\_before:** `Time`

  RFC 3339 timestamp (exclusive)

- **starting\_on:** `Time`

  RFC 3339 timestamp (inclusive)

- **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 CustomerListCostsResponse`

  - **credit\_types:** `Hash[Symbol, { cost, line_item_breakdown, name}]`

    - **cost:** `Float`

    - **line\_item\_breakdown:** `Array[{ cost, name, group_key, group_value}]`

      - **cost:** `Float`

      - **name:** `String`

      - **group\_key:** `String`

      - **group\_value:** `String`

    - **name:** `String`

  - **end\_timestamp:** `Time`

  - **start\_timestamp:** `Time`

### Example

```ruby
require "metronome_sdk"

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

page = metronome.v1.customers.list_costs(
  customer_id: "d7abd0cd-4ae9-4db7-8676-e986a4ebd8dc",
  ending_before: "2019-12-27T18:11:19.117Z",
  starting_on: "2019-12-27T18:11:19.117Z"
)

puts(page)
```