Cuentas

Una cuenta es cualquier lugar donde guardas dinero: un banco, efectivo, una billetera digital. Cada una tiene una sola moneda.

El objeto cuenta

Campos

iduuid: Identificador de la cuenta.
namestring: Nombre visible, hasta 100 caracteres.
currencystring: VES, USD, USDT, EUR, BRL o COP. No cambia después de crearla.
balanceMinorinteger: Saldo actual en céntimos, calculado en vivo desde los movimientos.
monthIncomeMinorinteger: Ingresos del mes en curso, en céntimos.
monthExpenseMinorinteger: Gastos del mes en curso, en céntimos.
initialBalanceMinorinteger: Saldo inicial configurado, en céntimos.
colorinteger: Color en formato ARGB de 32 bits, el mismo que usa la app.
iconstring: Nombre del ícono, por ejemplo wallet o bank.
cardStylestring: Estilo de la tarjeta en la app: default, aura, orbit…
positioninteger: Orden en la lista, de menor a mayor.
createdAt, updatedAtdatetime: Fechas de creación y última edición, en UTC.

Listar cuentas

GEThttps://api.tuplatica.app/api/platica/accounts

Plan: ProPermiso de la key: Solo lectura o superior

Devuelve todas tus cuentas activas, ordenadas por posición, con el saldo y los totales del mes.

curl "https://api.tuplatica.app/api/platica/accounts" \
  -H "Authorization: Bearer $PLATICA_API_KEY"

Respuesta 200

[
  {
    "id": "6f1c2a9e-8b4d-4c1e-9a7f-2d5e8b3c1a40",
    "name": "Banesco",
    "currency": "VES",
    "color": -16711936,
    "position": 0,
    "icon": "bank",
    "cardStyle": "default",
    "balanceMinor": 1845000,
    "monthIncomeMinor": 2500000,
    "monthExpenseMinor": 655000,
    "initialBalanceMinor": 0,
    "createdAt": "2026-09-02T14:10:00.000Z",
    "updatedAt": "2026-10-18T13:22:41.000Z"
  }
]

Crear una cuenta

POSThttps://api.tuplatica.app/api/platica/accounts

Plan: ProPermiso de la key: Lectura y escritura

Cuerpo

namestringobligatorio: Nombre visible, hasta 100 caracteres.
currencystringobligatorio: VES, USD, USDT, EUR, BRL o COP.
colorintegerobligatorio: Color ARGB de 32 bits.
iduuid: Tu propio id. Reenviar el mismo id devuelve la cuenta existente en vez de duplicarla.
iconstring: Por defecto wallet.
cardStylestring: Por defecto default.
positioninteger: Por defecto 0.

curl -X POST "https://api.tuplatica.app/api/platica/accounts" \
  -H "Authorization: Bearer $PLATICA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Efectivo dólares",
    "currency": "USD",
    "color": -12627531
  }'

Responde 201 con la cuenta creada.

Editar una cuenta

PATCHhttps://api.tuplatica.app/api/platica/accounts/:id

Plan: ProPermiso de la key: Lectura y escritura

Envía solo los campos que quieres cambiar. La moneda no se puede cambiar.

Cuerpo

namestring: Nuevo nombre.
colorinteger: Nuevo color ARGB.
iconstring: Nuevo ícono.
cardStylestring: Nuevo estilo de tarjeta.
positioninteger: Nueva posición en la lista.

curl -X PATCH "https://api.tuplatica.app/api/platica/accounts/6f1c2a9e-8b4d-4c1e-9a7f-2d5e8b3c1a40" \
  -H "Authorization: Bearer $PLATICA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Banesco nómina"
  }'

Eliminar una cuenta

DELETEhttps://api.tuplatica.app/api/platica/accounts/:id

Plan: ProPermiso de la key: Lectura y escritura

Elimina la cuenta y deja de mostrarla en la app. Responde 204 sin cuerpo.

curl -X DELETE "https://api.tuplatica.app/api/platica/accounts/6f1c2a9e-8b4d-4c1e-9a7f-2d5e8b3c1a40" \
  -H "Authorization: Bearer $PLATICA_API_KEY"