---
title: "List department budgets"
method: GET
path: "/department-budgets"
tags: ["Gateway"]
---

# List department budgets

`GET /department-budgets`

## Request

- Base URL: `https://api.phaseo.app/v1`
- URL: `https://api.phaseo.app/v1/department-budgets`
- Auth: HTTP bearer

Lists department spend budgets with each department's spend so far in the current UTC period. Spend comes from an hourly rollup, so it can lag by up to an hour.

## Query parameters

- `department_id` string, uuid

## Response `200`

Department budgets

- DepartmentBudgetListResponse
  - `data` DepartmentBudget[], required
    - `id` string, uuid, required
    - `workspace_id` string, uuid, required
    - `department_id` string, uuid, required
    - `department_name` string, nullable, required
    - `interval` 'daily' | 'weekly' | 'monthly', required
    - `limit` number, double, required
    - `limit_nanos` integer, required
    - `usage` number, double, required
    - `usage_nanos` integer, required
    - `remaining` number, double, required
    - `remaining_nanos` integer, required
    - `exceeded` boolean, required
    - `window_start` string, date-time, nullable
    - `reset_at` string, date-time, nullable
    - `created_by` string, uuid, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `default`: Request failed

## Changes

- **2026-10-22** `dfb10c507ea9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/phaseo/apis/phaseo-gateway-api/changes/department-budgets/get.md)

---

[API](https://skmtc.dev/phaseo/apis/phaseo-gateway-api.md) - [All operations](https://skmtc.dev/phaseo/apis/phaseo-gateway-api/llms.txt) - [OpenAPI document](https://skmtc.dev/phaseo/apis/phaseo-gateway-api/revisions/5ca9bb220d25?raw)