v1

latestOpenAPI 3.0.22026-08-062794201004.1 KB

Billing

Download Categorized Billing

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.

post/v4/organizations/{organizationId}/billing/download

Request body

startDatestring date required

The start date of the billing period in YYYY-MM-DD format.

endDatestring date required

The end date of the billing period in YYYY-MM-DD format.

Example request

{
  "startDate": "2025-04-01",
  "endDate": "2025-04-30",
  "filters": {
    "categories": [
      "analyticsCompute",
      "analyticsStorage"
    ],
    "projectIds": [
      "ffffffff-aaaa-1414-eeee-000000000000",
      "ffffffff-aaaa-1414-eeee-000000000001"
    ],
    "instanceIds": [
      "ffffffff-aaaa-1414-eeee-000000000000",
      "ffffffff-aaaa-1414-eeee-000000000001"
    ]
  }
}

Response

Successfully downloaded the categorized billing information as a CSV file.