---
title: "Budgets returns all budgets."
method: GET
path: "/cosmos/budget/v1beta1/budgets"
tags: ["Query"]
---

# Budgets returns all budgets.

`GET /cosmos/budget/v1beta1/budgets`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/crescent-network/apis/crescent-rest-and-grpc-gateway-docs/docs/cosmos/budget/v1beta1/budgets/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns all budgets.

## Query parameters

- `name` string
- `source_address` string
- `destination_address` string

## Response `200`

A successful response.

- object: QueryBudgetsResponse is the response type for the Query/Budgets RPC method.
  - `budgets` object[]
    - `budget` object: Budget defines a budget object.
      - `name` string
      - `rate` string
      - `source_address` string
      - `destination_address` string
      - `start_time` string, date-time
      - `end_time` string, date-time
    - `total_collected_coins` object[]
      - `denom` string
      - `amount` string

## Other responses

- `default`: An unexpected error response

## Changes

- **2023-09-11** `0cb495f8c604`: 1 info
  - endpoint added
- **2023-09-11** `65d4119fbf62`: 1 breaking
  - api path removed without deprecation
- **2023-06-22** `445be7f5fce0`: 1 info
  - endpoint added
- **2023-02-13** `408c42c3d18b`: 1 breaking
  - api path removed without deprecation
- **2022-03-17** `050a36bde231`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/crescent-network/apis/crescent-rest-and-grpc-gateway-docs/changes/cosmos/budget/v1beta1/budgets/get.md)

---

[API](https://skmtc.dev/crescent-network/apis/crescent-rest-and-grpc-gateway-docs.md) - [All operations](https://skmtc.dev/crescent-network/apis/crescent-rest-and-grpc-gateway-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/crescent-network/apis/crescent-rest-and-grpc-gateway-docs/revisions/ddf5133cea9d?raw)