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

# Download Categorized Billing

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

Downloads a csv file with categorized billing information for the organization within the specified date range and filters.
Downloaded CSV file named `capella-categorized-billing-{organizationId}-{startDate}_to_{endDate}.csv` with the following columns:
- `startDate` : The start date
- `endDate` : The end date
- `category`: The category name
- `creditSpend`: Usage in Capella credits for this category
- `currencySpend`: Usage in dollar or any billingCurrency amount for this category
- `contributionPercent`: contributionPercent of total consumption
- `billingCurrency`: currency

`Total` - The final row of the CSV will contain totals across all categories over the full time period

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 downloaded the categorized billing information as a CSV file.

## 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/27d3c1e98fee/schema)