---
title: "Get Budgets"
method: GET
path: "/v2/budgets"
tags: ["Routes", "Budgets"]
---

# Get Budgets

`GET /v2/budgets`

This request returns your Budgets in Limble. 

Return data description

Property: budgetID, Description: The Budget's unique identifier.
Property: name, Description: The full name of the Budget.
Property: locationID, Description: Which Location this Budget belongs to.

## Query parameters

- `cursor` integer
- `limit` integer
- `name` string
- `locations` string
- `budgets` string

## Response `200`

Get Budgets

- Budget[]
  - `budgetID` integer
  - `name` string
  - `locationID` integer
  - `awaitingAllowPOEdit` boolean
  - `awaitingUserID` integer
  - `awaitingProfileID` integer
  - `awaitingEmailSend` boolean
  - `prUserID` integer
  - `prProfileID` integer
  - `prEmailSend` boolean
  - `defaultBudget` object
    - `global` boolean
    - `purchaseRequests` boolean
    - `minPartQtyPOs` boolean
  - `meta` object
    - `steps` string
    - `location` string

## Other responses

- `400` — The request was malformed — either invalid JSON syntax or a validation failure (missing required field, wrong type, etc.).
- `401` — No `Authorization` header was provided on the request.
- `403` — The supplied credentials are invalid, the customer account is inactive, or the credentials do not have permission to perform this action.
- `429` — The per-minute or per-hour rate limit for this credential and method has been exhausted. Inspect the `X-RateLimit-*` headers to determine when to retry.
- `500` — An unhandled server-side error. The body message is generic (`System unavailable...`) when the underlying cause is a database fault; otherwise it reflects the raised error.

---

[API](https://skmtc.net/limblecmms/apis/limble-api-v2.md) · [All operations](https://skmtc.net/limblecmms/apis/limble-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/limblecmms/limble-api-v2/revisions/20801e23f7f2/schema)