Listar presupuestos

GET /v1/budgets

Devuelve todos los presupuestos de tu empresa. Úsalo para reutilizar presupuestos entre viajes y evitar duplicados antes de crear uno nuevo (el nombre es único por empresa).

Ejemplo

curl https://api.sandbox.partner.uvicuo.com/v1/budgets \
  -H "X-API-Key: $UVICUO_API_KEY"

Respuesta

200 OK

{
  "budgets": [
    {
      "id": "c9bdaa14-264e-8f36-e60a-7eb9b73fbeea",
      "name": "Presupuesto Flota Q1",
      "state": "ACTIVE",
      "route_id": null,
      "route_name": null,
      "total_amount": { "amount": 10000.00, "currency": "MXN" },
      "periodicity": null,
      "payment_method_configs": [ /* … */ ],
      "created_at": "2026-06-04T14:02:31.617Z",
      "updated_at": "2026-06-04T14:02:31.617Z"
    }
  ]
}

Campos de cada presupuesto

Campo	Tipo	Descripción
`id`	string (UUID)	Identificador del presupuesto. Úsalo como `budget_id` al crear un plan de gasto.
`name`	string	Nombre del presupuesto (único por empresa).
`state`	`ACTIVE` \| `DELETED`	Estado del presupuesto.
`route_id`	string (UUID) \| null	Ruta asociada, si la hay.
`route_name`	string \| null	Nombre de la ruta asociada.
`total_amount`	objeto \| null	Monto total (`amount` + `currency`).
`periodicity`	objeto \| null	Periodicidad de renovación, si se configuró `frequency`.
`payment_method_configs`	array	Las configuraciones por método de pago del presupuesto.
`created_at` / `updated_at`	date-time	Fechas de creación y última actualización (ISO 8601).

Errores comunes

HTTP / `code`	Situación
`401 unauthorized`	Falta o es inválida la `X-API-Key`.