Metas de ahorro

Una meta es un monto que quieres alcanzar. Se vincula a cuentas o planes, y su avance sale del saldo de esas cuentas.

El objeto meta

Campos

iduuid: Identificador de la meta.
namestring: Nombre, hasta 100 caracteres.
targetAmountMinorinteger: Monto que quieres alcanzar, en céntimos.
currencystring: Moneda de la meta: VES, USD, USDT, EUR, BRL o COP.
iconstring: Nombre del ícono. Por defecto target.
positioninteger: Orden en la lista.
accountIdsuuid[]: Cuentas vinculadas. Su saldo suma al avance.
planIdsuuid[]: Planes vinculados.
createdAt, updatedAtdatetime: Creación y última edición, en UTC.

El avance no viene en la respuesta

Platica no guarda el avance: se calcula sumando el balanceMinor de las cuentas en accountIds (de GET /accounts) y comparándolo con targetAmountMinor.

Listar metas

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

Plan: ProPermiso de la key: Solo lectura o superior

Devuelve todas tus metas, ordenadas por posición.

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

Respuesta 200

[
  {
    "id": "3a8f1c62-4d7e-4b9a-a1c5-9e2f7d0b4c18",
    "name": "Carro",
    "targetAmountMinor": 500000000,
    "currency": "USD",
    "icon": "target",
    "position": 0,
    "accountIds": [
      "0d9a4b7e-3c21-4e6f-8a5b-1f2e3d4c5b6a"
    ],
    "planIds": [],
    "createdAt": "2026-08-01T15:00:00.000Z",
    "updatedAt": "2026-10-12T21:40:10.000Z"
  }
]

Crear una meta

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

Plan: ProPermiso de la key: Lectura y escritura

Cuerpo

namestringobligatorio: Hasta 100 caracteres.
targetAmountMinorintegerobligatorio: Monto meta en céntimos, mayor que cero.
currencystringobligatorio: VES, USD, USDT, EUR, BRL o COP.
accountIdsuuid[]: Cuentas tuyas a vincular.
planIdsuuid[]: Planes tuyos a vincular.
iconstring: Por defecto target.
positioninteger: Por defecto 0.
iduuid: Tu propio id. Reenviarlo devuelve la meta existente en vez de duplicarla.

curl -X POST "https://api.tuplatica.app/api/platica/goals" \
  -H "Authorization: Bearer $PLATICA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Carro",
    "targetAmountMinor": 500000000,
    "currency": "USD",
    "accountIds": [
      "0d9a4b7e-3c21-4e6f-8a5b-1f2e3d4c5b6a"
    ]
  }'

Respuesta 201

{
  "id": "3a8f1c62-4d7e-4b9a-a1c5-9e2f7d0b4c18",
  "name": "Carro",
  "targetAmountMinor": 500000000,
  "currency": "USD",
  "icon": "target",
  "position": 0,
  "accountIds": [
    "0d9a4b7e-3c21-4e6f-8a5b-1f2e3d4c5b6a"
  ],
  "planIds": [],
  "createdAt": "2026-08-01T15:00:00.000Z",
  "updatedAt": "2026-10-12T21:40:10.000Z"
}

Si alguna cuenta o plan vinculado no existe o no es tuyo, responde 404 y no crea nada.

Editar una meta

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

Plan: ProPermiso de la key: Lectura y escritura

Envía solo los campos que cambian: los mismos del cuerpo de creación, sin id. accountIds y planIds reemplazan la lista completa: para quitar un vínculo, manda la lista sin él.

curl -X PATCH "https://api.tuplatica.app/api/platica/goals/3a8f1c62-4d7e-4b9a-a1c5-9e2f7d0b4c18" \
  -H "Authorization: Bearer $PLATICA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "targetAmountMinor": 650000000
  }'

Eliminar una meta

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

Plan: ProPermiso de la key: Lectura y escritura

Elimina la meta. Las cuentas vinculadas no se tocan. Responde 204 sin cuerpo.

curl -X DELETE "https://api.tuplatica.app/api/platica/goals/3a8f1c62-4d7e-4b9a-a1c5-9e2f7d0b4c18" \
  -H "Authorization: Bearer $PLATICA_API_KEY"