VerifikaDocs
ReferenciaEgresos

Listar egresos

Gastos del negocio, paginados por cursor. Requiere el módulo de egresos en el plan además del permiso expenses.read.

GET
/expenses

Autorización

apiKey expenses.read
AutorizaciónBearer <token>

La llave del negocio, creada en el panel: Integraciones → API pública. Formato vk_live_… (o vk_test_… fuera de producción).

Va en: header

Permiso: expenses.read

Parámetros de consulta

companyId?string

Sobre qué negocio actúa la petición. Obligatorio solo si la llave entra a varios negocios (plan Multi); con uno solo, se deduce.

limit?integer

Filas por página.

Rango1 <= value <= 100
Por defecto50
startingAfter?string

Cursor: el nextCursor de la página anterior.

from?string
to?string
categoryId?array<string>

Categoría de gasto. Repetible.

branchId?array<string>

Sucursal. Repetible.

minAmount?integer
maxAmount?integer
q?string

Busca en «pagado a» y en las notas.

Cuerpo de la respuesta

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/expenses"
{  "object": "list",  "data": [    {      "object": "expense",      "id": "cmtk9xq2z0041suw1n7mmb0af",      "amount": 120000,      "currency": "COP",      "paidTo": "Harina La Espiga",      "occurredAt": "2026-09-03T14:10:00.000Z",      "createdAt": "2026-09-03T14:12:44.008Z",      "accountLabel": "Bancolombia *4643",      "paymentMethod": "TRANSFER",      "notes": "Pedido semanal",      "source": "PANEL",      "category": {        "id": "cmt7xbg1a0009q3w1v8s0nn1c",        "name": "Insumos",        "emoji": "🌾"      },      "branch": {        "id": "cmt7xbfrj0002q3w1iq4ysatr",        "name": "Principal"      },      "createdBy": {        "id": "cmt8u1p9r00035pw1kq0v2xdc",        "name": "Laura Gómez",        "phone": null      }    }  ],  "hasMore": false,  "nextCursor": null}

Listar categorías de egreso GET

Las categorías del negocio, para poder mandar un categoryId válido al crear un egreso. Solo lectura, a propósito. Un ERP con su propio catálogo llenaría el libro de categorías duplicadas sin querer, y el dueño ya las administra en el panel, donde las ve todas de una vez.

Editar un egreso PATCH

Siguiente