---
title: "List of Costs"
method: GET
path: "/billing/v1/costs"
tags: ["Costs (billing/v1)"]
---

# List of Costs

`GET /billing/v1/costs`

[![General Availability](https://img.shields.io/badge/Lifecycle%20Stage-General%20Availability-%2345c6e8)](#section/Versioning/API-Lifecycle-Policy)

Retrieve a sorted, filtered, paginated list of all costs.

## Query parameters

- `start_date` string, required — Filter a collection by a string search
- `end_date` string, required — Filter a collection by a string search
- `page_size` integer
- `page_token` string

## Response `200`

Cost.

- BillingV1CostList — `Cost` objects represent the aggregated billing costs for an organization Related guide: [Retrieve costs for a range of dates](https://docs.confluent.io/cloud/current/billing/overview.html#retrieve-costs-for-a-range-of-dates). ## The Costs Model <SchemaDefinition schemaRef="#/components/schemas/billing.v1.Cost" />
  - `api_version` 'billing/v1', required — APIVersion defines the schema version of this representation of a resource.
  - `kind` 'CostList', required — Kind defines the object this REST resource represents.
  - `metadata` object, required — CostListMeta describes metadata that resource collections may have
    - `next` string, uri, nullable — A link to the next page of results. If a response does not contain a next link, then there is no more data available.
  - `data` object[], required — A data property that contains an array of resource items. Each entry in the array is a separate resource.
    - `api_version` 'billing/v1' — APIVersion defines the schema version of this representation of a resource.
    - `kind` 'Cost' — Kind defines the object this REST resource represents.
    - `id` string, required — ID is the "natural identifier" for an object within its scope/namespace; it is normally unique across time but not space. That is, you can assume that the ID will not be reclaimed and reused after an object is deleted ("time"); however, it may collide with IDs for other object `kinds` or objects of the same `kind` within a different scope/namespace ("space").
    - `start_date` string, date, required — Start date of time period (inclusive) to retrieve billing costs. It is represented in RFC3339 format and is in UTC.
    - `end_date` string, date, required — End date of time period (exclusive) to retrieve billing costs. It is represented in RFC3339 format and is in UTC.
    - `granularity` string — Granularity at which each line item is aggregated.
    - `network_access_type` string — Network access type for the cluster.
    - `product` string — Product name.
    - `line_type` string — Type of the line item.
    - `price` number, double — Price for the line item in dollars.
    - `unit` string, required — Unit of the line item.
    - `quantity` number, double — Quantity of the line item.
    - `original_amount` number, double, required — Original amount accrued for this line item.
    - `discount_amount` number, double — Amount discounted from the original amount in dollars.
    - `amount` number, double — Final amount after deducting discounts.
    - `description` string — Additional details about promotional offers/credits.
    - `tier_dimensions` object — Tier dimensions which exist for tiered pricing cost items only.
    - `resource` BillingV1Resource — The resource associated with this object. The resource can be one of Kafka Cluster ID (example: lkc-12345), Connector ID (example: lcc-12345), Schema Registry Cluster ID (example: lsrc-12345), or ksqlDB Cluster ID (example: lksqlc-12345). May be null or omitted if not associated with a resource.
      - `id` string — ID of the resource.
      - `display_name` string — Display name of the resource.
      - `environment` BillingV1Environment — The details of the environment for a given resource.
        - `id` string — ID of the environment.

## Other responses

- `400` — Bad Request
- `401` — The request lacks valid authentication credentials for this resource.
- `403` — The access credentials were considered insufficient to grant access
- `429` — Rate Limit Exceeded
- `500` — Oops, something went wrong!

---

[API](https://skmtc.dev/confluent/apis/confluent-cloud-apis.md) · [All operations](https://skmtc.dev/confluent/apis/confluent-cloud-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/confluent/confluent-cloud-apis/revisions/a6a73f98a698/schema)