---
title: "Calculate potential budget usage, for use while creating/setting budgets"
method: GET
path: "/v1/org/{orgId}/budget/calculate-usage"
tags: ["budget"]
---

# Calculate potential budget usage, for use while creating/setting budgets

`GET /v1/org/{orgId}/budget/calculate-usage`

## Path parameters

- `orgId` string, required

## Query parameters

- `groupIds` string
- `costExpr` string
- `currency` string
- `date` string, date
- `costBasis` string
- `startDate` string, date
- `endDate` string, date

## Response `200`

successful operation

- BudgetUsageResponse
  - `usage` Money, required
    - `amount` number, required
    - `currency` string, required
    - `places` integer
  - `basis` 'ANNUALIZED' | 'PERIOD_TOTAL', required
  - `openJobsMissingCompAndBand` integer — Count of open (unfilled) jobs in scope that have neither their own comp nor a comp band

## Other responses

- `400` — invalid data
- `401` — not authorized
- `403` — permission denied
- `404` — not found

---

[API](https://skmtc.net/charthop/apis/charthop-api.md) · [All operations](https://skmtc.net/charthop/apis/charthop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/charthop/charthop-api/revisions/33fc84a173ce/schema)