Quickstart - Finzaria

En 3 pasos vas a autenticarte y hacer tu primera llamada real.

Crea tu API key

Entra a la app en app.finzaria.com → menú de tu perfil → Developers → Crear API key.Copia el valor (empieza con bxm_) en el momento: por seguridad se muestra una sola vez. Guárdalo en tu gestor de secretos, nunca en el código ni en el navegador.

Elige el scope read_write si vas a crear/editar, o read_only si solo vas a leer.

Guarda tu key como variable de entorno

export FINZARIA_API_KEY="bxm_tu_key_aqui"

Haz tu primera llamada

Pide tu workspace — confirma que la autenticación funciona y siempre devuelve algo:

curl https://api.finzaria.com/v1/workspace \
  -H "Authorization: Bearer $FINZARIA_API_KEY"

const res = await fetch("https://api.finzaria.com/v1/workspace", {
  headers: { Authorization: `Bearer ${process.env.FINZARIA_API_KEY}` },
})
const workspace = await res.json()
console.log(workspace)

import os, requests

res = requests.get(
    "https://api.finzaria.com/v1/workspace",
    headers={"Authorization": f"Bearer {os.environ['FINZARIA_API_KEY']}"},
)
print(res.json())

Deberías ver algo así (200 OK):

{
  "id": "9f8c…",
  "name": "Personal",
  "baseCurrency": "MXN"
}

Crea tu primera transacción

Ya autenticado, registra un gasto. Los montos van como string decimal y la fecha como YYYY-MM-DD:

curl https://api.finzaria.com/v1/transactions \
  -H "Authorization: Bearer $FINZARIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "expense",
    "amount": "150.50",
    "date": "2026-07-14",
    "description": "Café",
    "accountId": "ACCOUNT_ID"
  }'

const res = await fetch("https://api.finzaria.com/v1/transactions", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.FINZARIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    type: "expense",
    amount: "150.50",
    date: "2026-07-14",
    description: "Café",
    accountId: "ACCOUNT_ID",
  }),
})
console.log(await res.json())

¿No tienes un accountId? Lístalas con GET /v1/accounts o crea una con POST /v1/accounts. Para no duplicar transacciones si reintentas, usa el header Idempotency-Key.

Siguientes pasos

Autenticación a fondo

API keys, OAuth y buenas prácticas de seguridad.

Explora la API

Todos los endpoints con playground para probarlos aquí mismo.

Maneja errores

Formato problem+json y tabla de códigos estables.

Conecta un agente

Usa Finzaria desde Claude o ChatGPT vía MCP.

​Crea tu primera transacción

​Siguientes pasos

Autenticación a fondo

Explora la API

Maneja errores

Conecta un agente

Crea tu primera transacción

Siguientes pasos