Budget request

List budget requests

Budget requests ("solicitudes de presupuesto") of the company, newest first, at most 200 (not paginated).

Admin / budgets_manage users see every request of the company, plus the company's free balance (company_unreserved_cents, what an approval of more funds can take) and each request's next_period_check. Any other member sees only their own requests, with both as null.

get/v1/budget_requests

Request

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

Query parameters

status'pending' | 'approved' | 'rejected' | 'withdrawn' | 'canceled'

Only requests in this status. An unknown value is ignored.

kind'more_funds' | 'new_budget'

Only requests of this kind. An unknown value is ignored.

budget_idstring uuid

Only requests about this budget.

Parameters

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

Response

The requests the caller can see.

company_unreserved_centsinteger nullable required

The company's free balance (not reserved by any budget). Only for admin / budgets_manage users; null for anyone else.

Example response

{
  "requests": [
    {
      "kind": "more_funds",
      "status": "pending",
      "requested_amount_cents": 500000,
      "approved_amount_cents": 400000,
      "currency": "CLP",
      "period_scope": "current_period",
      "reason": "Viaje a la feria de Santiago",
      "name": "Eventos Q4",
      "origin_channel": "web"
    }
  ],
  "company_unreserved_cents": 12000000
}

Changes

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