---
title: "Get Budgets"
method: GET
path: "/budget-accounts"
tags: ["Boost", "Budget"]
---

# Get Budgets

`GET /budget-accounts`

Accepts pagination, and filter options like owner address, chain ID, and permissioned member address.

## Query parameters

- `chainId` integer, nullable — Query for Budget Accounts deployed to this chain ID
- `member` string — Query for Budget Accounts where this member has permissions
- `owner` string — Query for Budget Accounts owned by this address
- `page` integer, nullable — Query for a specific page of results
- `pageSize` integer, nullable — How many items should be returned per page

## Response `200`

Returns whether or not the token is blocked on given chain id

- object[]
  - `id` string, required — The system ID in the format of "chainId:address"
  - `identifier` string, required — The address of the deployed Budget Account
  - `registryType` 'ACTION' | 'ALLOW_LIST' | 'BUDGET' | 'INCENTIVE' | 'VALIDATOR', required — The type of Boost Protocol V2 component; either ACTION, ALLOW_LIST, BUDGET, INCENTIVE, or VALIDATOR
  - `baseImplementation` string, required — The contract address of the base implementation registered with the protocol
  - `deployedInstance` string, required — The address of the deployed contract
  - `txHash` string, required — The transaction hash of the contract deployment
  - `blockTimestamp` string, required — A bigint string representing the block timestamp for this contract deployment
  - `blockNumber` string, required — A bigint string representing the blocknumber for this contract deployment
  - `chainId` integer, required — The chainID where this Budget is deployed
  - `name` string — A unique name for the Budget, if not updated later, then this will be a random UUID
  - `label` string, nullable — A label for the Budget, if available.
  - `address` string, required — The address of the deployed Budget Account
  - `owner` string, required — The address of the Budget's owner
  - `hidden` boolean, required — Whether or not the Budget should be included in API responses
  - `members` object[], required — A list of members with any amount of permissions
    - `memberAddress` string, required — The address of the Budget Account member, someone with either ADMIN or MANAGER permissions
    - `roles` number[], required — A list of numbers representing role enums, where 1 is MANAGER, and 2 is ADMIN. Managers can manage funds, while Admins can manage permissioned users.
    - `email` string, nullable — The email address associated with this member, if available
    - `status` 'wallet_created' | 'invited' | 'accepted' | 'cancelled', nullable — The invitation status of this member, if available
  - `deprecated` boolean, required — Will be true if Budget Account is based off of a deprecated budget implementation.

---

[API](https://skmtc.dev/boost/apis/boost-v2-api.md) · [All operations](https://skmtc.dev/boost/apis/boost-v2-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/boost/boost-v2-api/revisions/23f55c70a429/schema)