COcouchbase
Billing

Download Categorized Billing

Changed on

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:

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

Request

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.

Changes

  • fcc4f29578b1Revision changes
    • info

      added the new aiServicesAgentMemory enum value to the request property //

    • info

      added the new aiServicesMcpServer enum value to the request property //

    • info

      added the new operationalExpressScaling enum value to the request property //