Skip to main content
GET
Get Project Cost

Authorizations

Authorization
string
header
required

Service Account Token authentication. To authenticate API requests:

  1. Create a Service Account Token:

    • Go to the Cerebrium Dashboard and open the API Keys page
    • Click Create Service Account, name it (e.g., "GitHub Actions CI/CD"), choose an expiry date, and click Create
    • Copy the token generated for the desired service account
  2. Use the Token: Include the service account token in the Authorization header of API requests: Authorization: Bearer <your-service-account-token>

  3. Best Practices:

    • Create separate service accounts for different environments (dev, staging, prod)
    • Store tokens securely as secrets in consuming applications or workflows
    • Set appropriate expiry dates and rotate tokens regularly
    • Never commit tokens to source control

For CI/CD integration examples, see the CI/CD documentation.

Path Parameters

project_id
string
required

Query Parameters

month
string

Month to retrieve costs for, in YYYY-MM format. Defaults to the current month.

Response

Cost breakdown for the project for the requested month.

app_breakdown
array

Per-app usage breakdown from billing. Each item has app_name (string), cpu_cost_cents, cpu_seconds, gpu_cost_cents, gpu_seconds, memory_cost_cents, memory_seconds, and total_cost_cents fields.

breakdown
array

Per-app cost metrics for the month. Each item includes the app identifier with its CPU, GPU, and memory cost and usage figures.

coupons
array

Coupons applied to the account. Each item has coupon_name (string), amount_cents (integer), and amount_cents_remaining (integer) fields.

summary
object

Aggregated cost totals for the month, including compute cost and usage totals in cents and seconds, build cost totals, coupon discounts, and combined totals before and after discounts.