---
title: "Get all limits for a budget."
method: GET
path: "/v1/budgets/{id}/limits"
tags: ["budgets"]
---

# Get all limits for a budget.

`GET /v1/budgets/{id}/limits`

## Request

- Base URL: `https://demo.firefly-iii.org/api`
- URL: `https://demo.firefly-iii.org/api/v1/budgets/{id}/limits`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://demo.firefly-iii.org/oauth/authorize`
    - Token URL: `https://demo.firefly-iii.org/oauth/token`
  - HTTP bearer

Get all budget limits for this budget and the money spent, and money left. You can limit the list by submitting a date range as well. The "spent" array for each budget limit is NOT influenced by the start and end date of your query, but by the start and end date of the budget limit itself.

## Path parameters

- `id` string, required

## Query parameters

- `start` string, date
- `end` string, date

## Headers

- `X-Trace-Id` string, uuid

## Response `200`

A list of budget limits applicable to this budget.

- BudgetLimitArray
  - `data` BudgetLimitRead[], required
    - `type` string, string, required: Immutable value
    - `id` string, string, required
    - `attributes` BudgetLimitProperties, required
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `start` string, date-time: Start date of the budget limit.
      - `end` string, date-time: End date of the budget limit.
      - `budget_id` string, string: The budget ID of the associated budget.
      - `object_has_currency_setting` boolean: Indicates whether the object has a currency setting. If false, the object uses the administration's primary currency.
      - `currency_id` string, string: The currency ID of the currency associated with this object.
      - `currency_name` string, string: The currency name of the currency associated with this object.
      - `currency_code` string, string: The currency code of the currency associated with this object.
      - `currency_symbol` string, string
      - `currency_decimal_places` integer
      - `primary_currency_id` string, string: The currency ID of the administration's primary currency.
      - `primary_currency_name` string, string: The currency name of the administration's primary currency.
      - `primary_currency_code` string, string: The currency code of the administration's primary currency.
      - `primary_currency_symbol` string, string: The currency symbol of the administration's primary currency.
      - `primary_currency_decimal_places` integer: The currency decimal places of the administration's primary currency.
      - `amount` string, amount
      - `pc_amount` string, amount, nullable: The amount of this budget limit in the user's primary currency, if the original amount is in a different currency.
      - `period` string, string, nullable: Period of the budget limit. Only used when auto-generated by auto-budget.
      - `spent` ArrayEntryWithCurrencyAndSum[]: Amount(s) spent in the currencies in the database for this budget limit.
        - `currency_id` string, string
        - `currency_code` string, string
        - `currency_symbol` string, string
        - `currency_decimal_places` integer: Number of decimals supported by the currency
        - `sum` string, amount: The amount earned, spent or transferred.
      - `pc_spent` ArrayEntryWithCurrencyAndSum[]: Amount(s) spent in the primary currency in the database for this budget limit.
        - `currency_id` string, string
        - `currency_code` string, string
        - `currency_symbol` string, string
        - `currency_decimal_places` integer: Number of decimals supported by the currency
        - `sum` string, amount: The amount earned, spent or transferred.
      - `notes` string, string, nullable: Some notes for this specific budget limit.
  - `meta` Meta, required
    - `pagination` object
      - `total` integer
      - `count` integer
      - `per_page` integer
      - `current_page` integer
      - `total_pages` integer

## Other responses

- `400`: Bad request
- `401`: Unauthenticated
- `404`: Page not found
- `500`: Internal exception

---

[API](https://skmtc.dev/firefly-iii/apis/firefly-iii-api-v6-3-0-beta-2.md) - [All operations](https://skmtc.dev/firefly-iii/apis/firefly-iii-api-v6-3-0-beta-2/llms.txt) - [OpenAPI document](https://skmtc.dev/firefly-iii/apis/firefly-iii-api-v6-3-0-beta-2/revisions/a5f6f8195556?raw)