---
title: "List budgets · Budgets · COUNT Partner API"
description: "Returns all budgets in the workspace, optionally filtered by status. GET /partners/budgets"
canonical: "https://developers.getcount.com/reference/budgets/list-budgets"
source: "https://developers.getcount.com/reference/budgets/list-budgets"
---
[Budgets](https://developers.getcount.com/reference/budgets) / List budgets

# List budgets

GET `/partners/budgets`

Returns all budgets in the workspace, optionally filtered by status.

HMAC signature + Bearer access token

[Try this request](https://developers.getcount.com/tools/try-it?method=GET&path=%2Fpartners%2Fbudgets)

[Chart of Accounts API](https://developers.getcount.com/reference/chart-of-accounts) [Reports API](https://developers.getcount.com/reference/reports)

#### Query parameters

`status` enum optional

Filter by budget status.

One of: `draft`, `published`, `archived`

#### Responses

`200` Budget list.

`401` Missing or invalid HMAC signature, expired timestamp, or invalid Bearer token. [Troubleshoot](https://developers.getcount.com/getting-started/errors#error-401)

`403` The credential does not have access to this workspace or resource. [Troubleshoot](https://developers.getcount.com/getting-started/errors#error-403)

`429` Rate limit exceeded (100 requests per minute per clientId). Retry after the Retry-After header. [Troubleshoot](https://developers.getcount.com/getting-started/errors#error-429)

[Previous GET Get overall budget](https://developers.getcount.com/reference/budgets/get-overall-budget) [Next POST Create budget](https://developers.getcount.com/reference/budgets/create-budget)

GET `https://api.getcount.com/partners/budgets`

Request

```javascript
import crypto from 'node:crypto';

const BASE_URL = 'https://api.getcount.com';
const CLIENT_ID = process.env.COUNT_CLIENT_ID;
const CLIENT_SECRET = process.env.COUNT_CLIENT_SECRET;
const ACCESS_TOKEN = process.env.COUNT_ACCESS_TOKEN;

const method = 'GET';
const signingPath = '/budgets';
const timestamp = Math.floor(Date.now() / 1000).toString();
const bodyString = '';

const bodyHash = '';
const baseString = `${method}:${signingPath}:${timestamp}:${bodyHash}`;
const signature = crypto.createHmac('sha256', CLIENT_SECRET).update(baseString).digest('hex');

const response = await fetch(`${BASE_URL}/partners/budgets`, {
  method,
  headers: {
    'x-client-id': CLIENT_ID,
    'x-timestamp': timestamp,
    'x-signature': signature,
    Authorization: `Bearer ${ACCESS_TOKEN}`,
  },
});

console.log(await response.json());
```

Response · 200

```json
{
  "status": "success",
  "message": "Success on fetching budgets",
  "data": {
    "budgets": [
      {
        "id": "55667788-99aa-bbcc-ddee-ff0011223344",
        "name": "FY 2026 Operating Budget",
        "startPeriod": "2026-01-01",
        "cadence": "monthly",
        "actualPeriods": 3,
        "budgetPeriods": 12,
        "currencyCode": "USD",
        "status": "draft",
        "lockedAt": null,
        "isOverall": false,
        "versions": [
          {
            "versionNumber": 1,
            "label": "Initial",
            "isPublished": false,
            "createdAt": "2026-01-15T10:30:00.000Z"
          }
        ],
        "createdAt": "2026-01-15T10:30:00.000Z",
        "updatedAt": "2026-01-28T14:22:30.000Z"
      }
    ]
  }
}
```