Budget

List balance groups

Returns the company's active balance groups ("grupos de saldo" / budgets), each with its computed totals (committable_cents, available_cents, consumed_balance_cents), its embedded manager, and its bound vendor_cards.

Access

Admin / finance users (permission budgets_manage) see every group in the company.
Other users only see the groups they manage (manager_id == their user id).

The company is taken from the company-id header. This endpoint is not paginated — it returns all active groups in scope.

get/v1/budgets

Request

Base URL
https://api.cardda.com
URL
https://api.cardda.com/v1/budgets
Auth
HTTP bearer

Parameters

#/paths/~1v1~1bills/get/parameters/0 (unresolved $ref)

Response

Active balance groups in scope.

Example response

[
  {
    "name": "Marketing",
    "description": "Presupuesto del equipo de marketing",
    "currency": "CLP",
    "mode": "funded",
    "allocated_amount_cents": 5000000,
    "committable_cents": 3200000,
    "available_cents": 3500000,
    "consumed_balance_cents": -1500000,
    "used_cents": 1500000,
    "remaining_cents": 3500000,
    "vendor_cards": [
      {
        "last4": "4242",
        "limit_currency": "CLP"
      }
    ],
    "recurrence_unit": "month",
    "recurrence_every": 1,
    "base_amount_cents": 5000000,
    "period_ends_on": "2026-11-20",
    "ends_on": "2026-12-01"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.