---
title: "Get Categorized Billing"
method: POST
path: "/v4/organizations/{organizationId}/billing"
tags: ["Billing"]
---

# Get Categorized Billing

`POST /v4/organizations/{organizationId}/billing`

Retrieves billing information for the organization within the specified date range and filters.

In order to access this endpoint, the provided API key must have at least one of the following roles:
- Organization Owner

To learn more, see [Organization, Project, and Database Access Overview](https://docs.couchbase.com/cloud/organizations/organization-projects-overview.html).

## Request body

- CategorizedBillingRequest
  - `startDate` string, date, required — The start date of the billing period in YYYY-MM-DD format.
  - `endDate` string, date, required — The end date of the billing period in YYYY-MM-DD format.
  - `filters` BillingFilters — Filters to narrow down the billing information.
    - `categories` string[] — List of billing categories to filter by.
    - `projectIds` string[] — List of project IDs to filter by.
    - `instanceIds` string[] — List of instance IDs to filter by. Can be cluster IDs, app service IDs, or AI workflow/model IDs.

## Response `200`

Successfully retrieved the categorized billing information.

- CategorizedBillingResponse
  - `data` object, required — The categorized billing data.
    - `periods` BillingPeriod[], required — List of billing periods. For date ranges within a month, each period represents a single day. For date ranges more than a month, each period represents a month.
      - `startDate` string, date, required — The start date of this billing period.
      - `endDate` string, date, required — The end date of this billing period.
      - `categories` BillingCategoryBreakdown[], required — List of category breakdowns for this period.
        - `category` string, required — The billing category name.
        - `creditSpend` number, double, nullable — Amount spent in credits for this category. Null if billing is in amount (currency).
        - `currencySpend` number, double, nullable — Amount spent in currency for this category. Null if billing is in credits.
        - `contributionPercent` number, double, required — The percentage this category contributes to the total spend.
      - `totalCreditSpend` number, double, nullable — Total credits spent across all categories in this period. Null if billing is in amount (currency).
      - `totalCurrencySpend` number, double, nullable — Total currency spent across all categories in this period. Null if billing is in credits.
    - `total` BillingPeriodTotal, required — The aggregate totals across all billing periods.
      - `startDate` string, date, required — The start date of the overall billing range.
      - `endDate` string, date, required — The end date of the overall billing range.
      - `categories` BillingCategoryBreakdown[], required — List of category breakdowns for the total period.
        - `category` string, required — The billing category name.
        - `creditSpend` number, double, nullable — Amount spent in credits for this category. Null if billing is in amount (currency).
        - `currencySpend` number, double, nullable — Amount spent in currency for this category. Null if billing is in credits.
        - `contributionPercent` number, double, required — The percentage this category contributes to the total spend.
      - `totalCreditSpend` number, double, nullable — Total credits spent across all periods and categories. Null if billing is in amount (currency).
      - `totalCurrencySpend` number, double, nullable — Total currency spent across all periods and categories. Null if billing is in credits.
    - `billingCurrency` string, required — The currency used for billing.

## Other responses

- `400` — Returned when we are unable to decode the recevied payload.
- `403` — The client does not have the necessary permissions to access this resource.
- `404` — The requested resource was not found.
- `422` — Request validation error.
- `429` — Returned when the client exceeds the rate limit for the given APIKey.
- `500` — An unexpected error occurred in the server while processing this request.

---

[API](https://skmtc.net/couchbase/apis/couchbase-capella-management-api.md) · [All operations](https://skmtc.net/couchbase/apis/couchbase-capella-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/couchbase/couchbase-capella-management-api/revisions/e67df5d1f74e/schema)