CAcardda
Budget

Create a balance group

Creates a balance group under the company from the company-id header. Requires admin or the budgets_manage permission.

All fields are nested under a budget key. The name must be unique per company among active (non-dissolved) groups.

post/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)

Request body

Example request

{
  "budget": {
    "name": "Marketing",
    "description": "Presupuesto del equipo de marketing",
    "currency": "CLP",
    "mode": "funded",
    "allocated_amount_cents": 5000000,
    "recurrence_unit": "month",
    "recurrence_every": 1,
    "ends_on": "2026-12-01"
  }
}

Response

The created balance group.

OR

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.