Sign in

v1

latestOpenAPI 3.0.22026-08-062794201004.1 KB
Billing

Get Categorized 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.

post/v4/organizations/{organizationId}/billing

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 retrieved the categorized billing information.

Example response

{
  "data": {
    "periods": [
      {
        "startDate": "2025-04-01",
        "endDate": "2025-04-30",
        "categories": [
          {
            "category": "analyticsCompute",
            "creditSpend": 90.1,
            "currencySpend": 90.1,
            "contributionPercent": 74
          }
        ],
        "totalCreditSpend": 3302.11,
        "totalCurrencySpend": 3302.11
      }
    ],
    "total": {
      "startDate": "2025-04-01",
      "endDate": "2025-04-30",
      "categories": [
        {
          "category": "analyticsCompute",
          "creditSpend": 90.1,
          "currencySpend": 90.1,
          "contributionPercent": 74
        }
      ],
      "totalCreditSpend": 26120.18,
      "totalCurrencySpend": 26120.18
    },
    "billingCurrency": "USD"
  }
}