Retrieve Invoices and Costs in Confluent Cloud

Use the Confluent Cloud Console to view or download invoices, or use the Costs API to retrieve costs for a date range.

View or download invoices

You can view or download current and past monthly invoices using Confluent Cloud Console. For information about line items on your invoice, see Billing Dimensions in Confluent Cloud.

Requirements

You must be assigned the OrganizationAdmin role or BillingAdmin role.

To view an invoice:

Sign in to your Confluent Cloud account.
Open the Administration menu in the upper right, select Billing and payment.
From Billing, view the current month and year, or select a different month and year.
Choose an environment.
A billing statement appears that identifies a resource, usage, and cost per unit for that environment.

To download an invoice:

Sign in to your Confluent Cloud account.
Open the Administration menu in the upper right, select Billing and payment.
From Billing, select the desired month and year.
Select the download icon:
Your browser downloads a CSV file containing the billing details for the selected month and year. The file name is your Confluent Cloud Organization ID.

Retrieve costs for a range of dates

Use the Costs API to get your costs for a specific range of dates.

Requirements

You must be assigned the OrganizationAdmin role or BillingAdmin role.

Notes

Use UTC time for dates with the Costs API.
Specify a start date (inclusive) and end date (exclusive) as strings in this format: yyyy-mm-dd.
Cost data can take up to 72 hours to become available.
The start date can be up to one year in the past.
One month is the maximum window between start and end dates.
The Costs API aggregates all line values at a daily level.

Related

To map dimensions to Costs API line items, see Billing Dimensions in Confluent Cloud.

Note

For accuracy, Confluent recommends using a start_date that is at least 72 hours prior to the current date and time.

To retrieve costs

Confluent Cloud APIs

Use a GET request, and include a start date and end date.

Request

GET /billing/v1/costs?start_date={yyyy-mm-dd}&end_date={yyyy-mm-dd}
Host: api.confluent.cloud

Response

Highlighted lines indicate the range of dates from your request and total costs.

{
   "api_version": "v1",
   "kind": "CostList",
   "metadata": {
      "first": "https://api.confluent.cloud/billing/v1/costs",
      "last": "https://api.confluent.cloud/billing/v1/costs?page_token=bcAOehAY8F16YD84Z1wT",
      "prev": "https://api.confluent.cloud/billing/v1/costs?page_token=YIXRY97wWYmwzrax4dld",
      "next": "https://api.confluent.cloud/billing/v1/costs?page_token=UvmDWOB1iwfAIBPj6EYb",
      "total_size": 123
   },
   "data": [
      {
         "api_version": "v1",
         "kind": "Cost",
         "start_date": "2024-04-01",
         "end_date": "2024-05-01",
         "granularity": "DAILY",
         "network_access_type": "INTERNET",
         "product": "KAFKA",
         "line_type": "KAFKA_NUM_CKUS",
         "price": 1.5,
         "unit": "GB",
         "quantity": 99.95,
         "original_amount": 99.95,
         "discount_amount": 20.95,
         "amount": 79,
         "resource": {
            "environment": {
                  "id": "env-devexamp34"
            },
            "id": "lkc-devexamp12"
         },
      }
   ]
}

Costs API response for Confluent Cloud organization created before 5/15/2024

Response

Highlighted lines indicate the range of dates from your request and total costs.

{
   "api_version": "v1",
   "kind": "CostList",
   "metadata": {
      "first": "https://api.confluent.cloud/billing/v1/costs",
      "last": "https://api.confluent.cloud/billing/v1/costs?page_token=bcAOehAY8F16YD84Z1wT",
      "prev": "https://api.confluent.cloud/billing/v1/costs?page_token=YIXRY97wWYmwzrax4dld",
      "next": "https://api.confluent.cloud/billing/v1/costs?page_token=UvmDWOB1iwfAIBPj6EYb",
      "total_size": 123
   },
   "data": [
      {
      "api_version": "v1",
      "kind": "Cost",
      "id": "dlz-f3a90de",
      "metadata": {
         "self": "https://api.confluent.cloud/billing/v1/costs/c-12345",
         "resource_name": "crn://confluent.cloud/organization=9bb441c4-edef-46ac-8a41-c49e44a3fd9a/cost=c-12345",
         "created_at": "2006-01-02T15:04:05-07:00",
         "updated_at": "2006-01-02T15:04:05-07:00",
         "deleted_at": "2006-01-02T15:04:05-07:00"
      },
      "start_date": "2022-10-12",
      "end_date": "2022-10-15",
      "granularity": "DAILY",
      "network_access_type": "INTERNET",
      "product": "KAFKA",
      "line_type": "KAFKA_NUM_CKUS",
      "resource_name": "prod_cluster_1",
      "price": 1.5,
      "unit": "GB",
      "quantity": 99.95,
      "original_amount": 99.95,
      "discount_amount": 20.95,
      "amount": 79,
      "environment": {
         "id": "env-a12b34",
         "environment": "string",
         "related": "https://api.confluent.cloud/v2/environments/env-a12b34",
         "resource_name": "https://api.confluent.cloud/organization=9bb441c4-edef-46ac-8a41-c49e44a3fd9a/environment=env-a12b34"
      },
      "resource": {
         "id": "lkc-c29js0",
         "environment": "string",
         "related": "https://api.confluent.cloud/cmk/v2/clusters/lkc-c29js0",
         "resource_name": "https://api.confluent.cloud/organization=9bb441c4-edef-46ac-8a41-c49e44a3fd9a/environment=env-abc123/cloud-cluster=lkc-c29js0",
         "api_version": "string",
         "kind": "string"
      }
      }
   ]
}

For more information, see Costs API.

Confluent CLI

Use the Confluent CLI and the confluent billing cost list command to retrieve your costs:

confluent billing cost list --start-date <start-date> --end-date <end-date>

For more information, see confluent billing cost list.