# Finzaria

> API y documentación de Finzaria — finanzas personales para México, dev-first y agent-first.

## Docs

- [Catálogo de tipos de cuenta del workspace (ACC-012)](https://docs.finzaria.com/api-reference/account-types/catálogo-de-tipos-de-cuenta-del-workspace-acc-012.md)
- [Crea un tipo (reutiliza si el nombre ya existe, ACC-013)](https://docs.finzaria.com/api-reference/account-types/crea-un-tipo-reutiliza-si-el-nombre-ya-existe-acc-013.md)
- [Elimina un tipo reasignando sus cuentas a «Otro» (ACC-014)](https://docs.finzaria.com/api-reference/account-types/elimina-un-tipo-reasignando-sus-cuentas-a-«otro»-acc-014.md)
- [Renombra un tipo de cuenta (ACC-013)](https://docs.finzaria.com/api-reference/account-types/renombra-un-tipo-de-cuenta-acc-013.md)
- [Archiva la cuenta (ACC-005): fuera de selectores y net worth; historial intacto](https://docs.finzaria.com/api-reference/accounts/archiva-la-cuenta-acc-005:-fuera-de-selectores-y-net-worth;-historial-intacto.md)
- [Crea una cuenta (ACC-001)](https://docs.finzaria.com/api-reference/accounts/crea-una-cuenta-acc-001.md)
- [Edita una cuenta; balance = edición directa del saldo (ACC-003/004)](https://docs.finzaria.com/api-reference/accounts/edita-una-cuenta;-balance-=-edición-directa-del-saldo-acc-003004.md)
- [Lista las cuentas del workspace con su saldo (ACC-002)](https://docs.finzaria.com/api-reference/accounts/lista-las-cuentas-del-workspace-con-su-saldo-acc-002.md)
- [Net worth consolidado del workspace (ACC-002)](https://docs.finzaria.com/api-reference/accounts/net-worth-consolidado-del-workspace-acc-002.md)
- [Obtiene una cuenta](https://docs.finzaria.com/api-reference/accounts/obtiene-una-cuenta.md)
- [Restaura una cuenta archivada (ACC-006)](https://docs.finzaria.com/api-reference/accounts/restaura-una-cuenta-archivada-acc-006.md)
- [Crea una API key; el valor se muestra una sola vez (ADM-021)](https://docs.finzaria.com/api-reference/api-keys/crea-una-api-key;-el-valor-se-muestra-una-sola-vez-adm-021.md)
- [Lista las API keys (sólo prefijo; ADM-021/023)](https://docs.finzaria.com/api-reference/api-keys/lista-las-api-keys-sólo-prefijo;-adm-021023.md)
- [Revoca una API key con efecto inmediato (ADM-022)](https://docs.finzaria.com/api-reference/api-keys/revoca-una-api-key-con-efecto-inmediato-adm-022.md)
- [Crea un presupuesto recurrente para una categoría (BUD-001)](https://docs.finzaria.com/api-reference/budgets/crea-un-presupuesto-recurrente-para-una-categoría-bud-001.md)
- [Edita un budget; el progreso se recalcula (BUD-004)](https://docs.finzaria.com/api-reference/budgets/edita-un-budget;-el-progreso-se-recalcula-bud-004.md)
- [Elimina un budget; las transacciones quedan intactas (BUD-004)](https://docs.finzaria.com/api-reference/budgets/elimina-un-budget;-las-transacciones-quedan-intactas-bud-004.md)
- [Obtiene un budget con su progreso](https://docs.finzaria.com/api-reference/budgets/obtiene-un-budget-con-su-progreso.md)
- [Presupuestos del periodo con gasto, rollover y disponible (BUD-002/003)](https://docs.finzaria.com/api-reference/budgets/presupuestos-del-periodo-con-gasto-rollover-y-disponible-bud-002003.md)
- [Archiva la categoría y su subárbol: fuera de selectores, historial de reportes intacto. Reusar el nombre la revive.](https://docs.finzaria.com/api-reference/categories/archiva-la-categoría-y-su-subárbol:-fuera-de-selectores-historial-de-reportes-intacto-reusar-el-nombre-la-revive.md)
- [Crea una categoría (o cadena "Padre / Hijo"); si ya existe devuelve la existente con 200 (CAT-001/003)](https://docs.finzaria.com/api-reference/categories/crea-una-categoría-o-cadena-"padre-hijo";-si-ya-existe-devuelve-la-existente-con-200-cat-001003.md)
- [Lista plana de categorías con parentId y conteos — el árbol se arma en el cliente (CAT-008)](https://docs.finzaria.com/api-reference/categories/lista-plana-de-categorías-con-parentid-y-conteos-—-el-árbol-se-arma-en-el-cliente-cat-008.md)
- [Renombra y/o mueve una categoría bajo otro padre (CAT-003/004)](https://docs.finzaria.com/api-reference/categories/renombra-yo-mueve-una-categoría-bajo-otro-padre-cat-003004.md)
- [Restaura una categoría archivada (y sus ancestros, para que sea visible en el árbol)](https://docs.finzaria.com/api-reference/categories/restaura-una-categoría-archivada-y-sus-ancestros-para-que-sea-visible-en-el-árbol.md)
- [Tasa del día para convertir una moneda a la base (pre-llena transferencias, 09)](https://docs.finzaria.com/api-reference/exchange-rates/tasa-del-día-para-convertir-una-moneda-a-la-base-pre-llena-transferencias-09.md)
- [Health check del servicio](https://docs.finzaria.com/api-reference/health/health-check-del-servicio.md)
- [Actualiza mapeo/correcciones y re-valida (08 §Paso 2 y 3)](https://docs.finzaria.com/api-reference/imports/actualiza-mapeocorrecciones-y-re-valida-08-§paso-2-y-3.md)
- [Descarta el borrador o deshace la importación (a la papelera); idempotente (08)](https://docs.finzaria.com/api-reference/imports/descarta-el-borrador-o-deshace-la-importación-a-la-papelera;-idempotente-08.md)
- [Ejecuta la importación de forma atómica; idempotente (08 §Importación)](https://docs.finzaria.com/api-reference/imports/ejecuta-la-importación-de-forma-atómica;-idempotente-08-§importación.md)
- [Estado del borrador con la validación completa (08 §Paso 3)](https://docs.finzaria.com/api-reference/imports/estado-del-borrador-con-la-validación-completa-08-§paso-3.md)
- [Historial de importaciones (08)](https://docs.finzaria.com/api-reference/imports/historial-de-importaciones-08.md)
- [Sube un archivo (CSV/XLSX en base64) y crea un borrador de importación (08 §Paso 1)](https://docs.finzaria.com/api-reference/imports/sube-un-archivo-csvxlsx-en-base64-y-crea-un-borrador-de-importación-08-§paso-1.md)
- [Crea un contacto (o reutiliza uno igual por nombre/email)](https://docs.finzaria.com/api-reference/iou/crea-un-contacto-o-reutiliza-uno-igual-por-nombreemail.md)
- [Elimina un contacto sin movimientos; con actividad responde 409](https://docs.finzaria.com/api-reference/iou/elimina-un-contacto-sin-movimientos;-con-actividad-responde-409.md)
- [Historial de deuda del contacto con balance acumulado (IOU-007)](https://docs.finzaria.com/api-reference/iou/historial-de-deuda-del-contacto-con-balance-acumulado-iou-007.md)
- [Lista los contactos del workspace (IOU-005)](https://docs.finzaria.com/api-reference/iou/lista-los-contactos-del-workspace-iou-005.md)
- [NET IOU: posición neta por contacto y total (IOU-006)](https://docs.finzaria.com/api-reference/iou/net-iou:-posición-neta-por-contacto-y-total-iou-006.md)
- [Renombra, cambia email o archiva un contacto (IOU-005/006)](https://docs.finzaria.com/api-reference/iou/renombra-cambia-email-o-archiva-un-contacto-iou-005006.md)
- ["Registrar ahora": crea la ocurrencia vigente con fecha = vencimiento (REP-006)](https://docs.finzaria.com/api-reference/repeating-transactions/"registrar-ahora":-crea-la-ocurrencia-vigente-con-fecha-=-vencimiento-rep-006.md)
- [Crea una transacción repetida; si vence hoy y auto-registra, materializa ya (REP-001)](https://docs.finzaria.com/api-reference/repeating-transactions/crea-una-transacción-repetida;-si-vence-hoy-y-auto-registra-materializa-ya-rep-001.md)
- [Edita la regla; solo afecta ocurrencias futuras (REP-008)](https://docs.finzaria.com/api-reference/repeating-transactions/edita-la-regla;-solo-afecta-ocurrencias-futuras-rep-008.md)
- [Elimina la regla; las transacciones generadas quedan intactas (REP-010)](https://docs.finzaria.com/api-reference/repeating-transactions/elimina-la-regla;-las-transacciones-generadas-quedan-intactas-rep-010.md)
- [Obtiene una regla recurrente](https://docs.finzaria.com/api-reference/repeating-transactions/obtiene-una-regla-recurrente.md)
- [Ocurrencias que vencen en los próximos días (REP-006)](https://docs.finzaria.com/api-reference/repeating-transactions/ocurrencias-que-vencen-en-los-próximos-días-rep-006.md)
- [Pausa la regla: no materializa ni alerta (REP-009)](https://docs.finzaria.com/api-reference/repeating-transactions/pausa-la-regla:-no-materializa-ni-alerta-rep-009.md)
- [Reanuda: próxima fecha desde hoy, sin catch-up del periodo pausado (REP-009)](https://docs.finzaria.com/api-reference/repeating-transactions/reanuda:-próxima-fecha-desde-hoy-sin-catch-up-del-periodo-pausado-rep-009.md)
- [Reglas recurrentes con próximo vencimiento y gasto fijo mensual (REP-005)](https://docs.finzaria.com/api-reference/repeating-transactions/reglas-recurrentes-con-próximo-vencimiento-y-gasto-fijo-mensual-rep-005.md)
- [Salta la ocurrencia vigente (auditado); la próxima avanza (REP-007)](https://docs.finzaria.com/api-reference/repeating-transactions/salta-la-ocurrencia-vigente-auditado;-la-próxima-avanza-rep-007.md)
- [Agregados + serie por bucket + periodo anterior para la vista de detalle (11)](https://docs.finzaria.com/api-reference/reports/agregados-+-serie-por-bucket-+-periodo-anterior-para-la-vista-de-detalle-11.md)
- [Gasto por categoría en un periodo (RPT-001); sólo tipos-gasto](https://docs.finzaria.com/api-reference/reports/gasto-por-categoría-en-un-periodo-rpt-001;-sólo-tipos-gasto.md)
- [Crea una regla; opcionalmente la aplica a transacciones pasadas](https://docs.finzaria.com/api-reference/rules/crea-una-regla;-opcionalmente-la-aplica-a-transacciones-pasadas.md)
- [Edita la regla (reemplaza filtro y categoría); applyToPast re-aplica](https://docs.finzaria.com/api-reference/rules/edita-la-regla-reemplaza-filtro-y-categoría;-applytopast-re-aplica.md)
- [Elimina la regla; las transacciones ya etiquetadas no cambian](https://docs.finzaria.com/api-reference/rules/elimina-la-regla;-las-transacciones-ya-etiquetadas-no-cambian.md)
- [Lista las reglas de auto-etiquetado del workspace (TAG-007)](https://docs.finzaria.com/api-reference/rules/lista-las-reglas-de-auto-etiquetado-del-workspace-tag-007.md)
- [Transacciones que coincidirían con un filtro aún no guardado (10-reglas §5)](https://docs.finzaria.com/api-reference/rules/transacciones-que-coincidirían-con-un-filtro-aún-no-guardado-10-reglas-§5.md)
- [Transacciones vivas que coinciden con la regla](https://docs.finzaria.com/api-reference/rules/transacciones-vivas-que-coinciden-con-la-regla.md)
- [Crea una transacción; los saldos se ajustan atómicamente (TXN-001..003)](https://docs.finzaria.com/api-reference/transactions/crea-una-transacción;-los-saldos-se-ajustan-atómicamente-txn-001003.md)
- [Descripciones ya usadas para autocompletar, con la categoría que una regla aplicaría (10-reglas §3)](https://docs.finzaria.com/api-reference/transactions/descripciones-ya-usadas-para-autocompletar-con-la-categoría-que-una-regla-aplicaría-10-reglas-§3.md)
- [Edita en masa la selección; solo los campos presentes cambian, atómico (TXN-014)](https://docs.finzaria.com/api-reference/transactions/edita-en-masa-la-selección;-solo-los-campos-presentes-cambian-atómico-txn-014.md)
- [Edita una transacción; saldos y reportes se recalculan (TXN-004)](https://docs.finzaria.com/api-reference/transactions/edita-una-transacción;-saldos-y-reportes-se-recalculan-txn-004.md)
- [Lista transacciones con filtros y cursor (TXN-007/008)](https://docs.finzaria.com/api-reference/transactions/lista-transacciones-con-filtros-y-cursor-txn-007008.md)
- [Manda a la papelera (30 días) y revierte el saldo (TXN-005)](https://docs.finzaria.com/api-reference/transactions/manda-a-la-papelera-30-días-y-revierte-el-saldo-txn-005.md)
- [Manda a la papelera la selección revirtiendo saldos, atómico (TXN-014)](https://docs.finzaria.com/api-reference/transactions/manda-a-la-papelera-la-selección-revirtiendo-saldos-atómico-txn-014.md)
- [Obtiene una transacción con su categoría](https://docs.finzaria.com/api-reference/transactions/obtiene-una-transacción-con-su-categoría.md)
- [Papelera: borradas en los últimos 30 días (TXN-005)](https://docs.finzaria.com/api-reference/transactions/papelera:-borradas-en-los-últimos-30-días-txn-005.md)
- [Restaura desde la papelera y re-aplica el saldo (TXN-005)](https://docs.finzaria.com/api-reference/transactions/restaura-desde-la-papelera-y-re-aplica-el-saldo-txn-005.md)
- [Edita el workspace; cambiar baseCurrency re-etiqueta consolidados sin tocar datos (09)](https://docs.finzaria.com/api-reference/workspace/edita-el-workspace;-cambiar-basecurrency-re-etiqueta-consolidados-sin-tocar-datos-09.md)
- [Workspace actual (incluye moneda base de reporte, 09)](https://docs.finzaria.com/api-reference/workspace/workspace-actual-incluye-moneda-base-de-reporte-09.md)
- [Changelog](https://docs.finzaria.com/changelog.md): Novedades de la API, el MCP y la documentación de Finzaria.
- [API keys](https://docs.finzaria.com/guias/autenticacion/api-keys.md): Autentica tus integraciones server-to-server con una API key bxm_ de Finzaria.
- [OAuth 2.1](https://docs.finzaria.com/guias/autenticacion/oauth.md): Conecta apps y agentes a la cuenta de un usuario con OAuth 2.1 (authorization code + PKCE).
- [Scopes y permisos](https://docs.finzaria.com/guias/autenticacion/scopes.md): Qué puede hacer cada tipo de credencial en la API de Finzaria.
- [Categorías](https://docs.finzaria.com/guias/conceptos/categorias.md): Cómo se organizan los gastos e ingresos: jerarquía, ruta, tipo y emoji.
- [Cuentas](https://docs.finzaria.com/guias/conceptos/cuentas.md): Dónde vive el dinero: cuentas, tipos, saldo y patrimonio neto.
- [Multi-divisa](https://docs.finzaria.com/guias/conceptos/multi-divisa.md): Moneda por cuenta, moneda base para reportes y traspasos con tipo de cambio.
- [Transacciones recurrentes](https://docs.finzaria.com/guias/conceptos/recurrentes.md): Automatiza movimientos que se repiten: renta, nómina, suscripciones.
- [Reglas de auto-categorización](https://docs.finzaria.com/guias/conceptos/reglas.md): Categoriza transacciones automáticamente por su descripción.
- [Transacciones](https://docs.finzaria.com/guias/conceptos/transacciones.md): El corazón de Finzaria: tipos de transacción, campos, categoría y papelera.
- [Documentación de Finzaria](https://docs.finzaria.com/guias/index.md): Conecta tu cuenta de Finzaria por API o por un agente en minutos. Dev-first y agent-first.
- [Quickstart](https://docs.finzaria.com/guias/quickstart.md): De cero a tu primera llamada exitosa a la API de Finzaria en menos de 5 minutos.
- [Errores](https://docs.finzaria.com/guias/referencia-transversal/errores.md): Formato problem+json y tabla de códigos estables para manejar (y auto-corregir) errores.
- [Idempotencia](https://docs.finzaria.com/guias/referencia-transversal/idempotencia.md): Reintenta escrituras sin miedo a duplicar usando el header Idempotency-Key.
- [Paginación](https://docs.finzaria.com/guias/referencia-transversal/paginacion.md): Recorre listas grandes con paginación por cursor, estable ante escrituras concurrentes.
- [Rate limits](https://docs.finzaria.com/guias/referencia-transversal/rate-limits.md): Límites de peticiones, headers que los reportan y cómo reintentar bien.
- [Versionado](https://docs.finzaria.com/guias/referencia-transversal/versionado.md): Cómo versiona Finzaria su API y qué esperar de cambios y deprecaciones.
- [Categorizar transacciones automáticamente](https://docs.finzaria.com/guias/tareas/categorizar-automaticamente.md): Crea una regla, pruébala y aplícala al historial.
- [Registrar una transacción](https://docs.finzaria.com/guias/tareas/registrar-transaccion.md): Receta completa: de la cuenta a un gasto categorizado, sin duplicar.
- [Construir un reporte de gastos](https://docs.finzaria.com/guias/tareas/reporte-de-gastos.md): Resumen del periodo y desglose por categoría con dos llamadas.
- [Cuenta y seguridad](https://docs.finzaria.com/manual/cuenta-seguridad.md): Oculta tus saldos, conecta apps o agentes, y cuida tu información.
- [Cuentas y saldos](https://docs.finzaria.com/manual/cuentas.md): Agrega tus cuentas y entiende tu patrimonio en Finzaria.
- [Preguntas frecuentes](https://docs.finzaria.com/manual/faq.md): Dudas comunes sobre Finzaria.
- [Manual de usuario](https://docs.finzaria.com/manual/index.md): Aprende a usar Finzaria: cuentas, transacciones, presupuestos y más — sin tecnicismos.
- [Presupuestos y reportes](https://docs.finzaria.com/manual/presupuestos-reportes.md): Ponte límites por categoría y entiende a dónde se va tu dinero.
- [Primeros pasos](https://docs.finzaria.com/manual/primeros-pasos.md): Crea tu cuenta de Finzaria y conoce tu pantalla de inicio.
- [Reglas automáticas](https://docs.finzaria.com/manual/reglas.md): Deja que Finzaria categorice tus movimientos por ti.
- [Transacciones](https://docs.finzaria.com/manual/transacciones.md): Registra gastos e ingresos y organízalos por categoría.
- [Conectar tu agente](https://docs.finzaria.com/mcp/conectar.md): Agrega Finzaria como conector MCP en Claude o ChatGPT en un par de minutos.
- [Herramientas del MCP](https://docs.finzaria.com/mcp/herramientas.md): Las acciones que un agente puede ejecutar sobre tu cuenta de Finzaria.
- [MCP y agentes](https://docs.finzaria.com/mcp/overview.md): Conecta Finzaria a Claude, ChatGPT y otros agentes vía el servidor MCP — finanzas por conversación.
- [Referencia de API](https://docs.finzaria.com/referencia/overview.md): Todos los endpoints de la API /v1 de Finzaria, con playground interactivo.

## OpenAPI Specs

- [v1](https://docs.finzaria.com/openapi/v1.json)