API de Era

Aprobar un agente crea una clave

Cuando apruebas un agente por OAuth, Era le crea una clave de API. Aparece en la misma lista del panel que las que creas tú, con un nombre que Era arma a partir del nombre del propio cliente.

Lleva exactamente los alcances que aprobaste en esa pantalla, y nada más. Revócala desde el panel y el agente no podrá obtener acceso nuevo hasta que lo apruebes de nuevo. Un token que ya tenga sigue funcionando hasta que venza, como mucho en una hora.

Las escrituras aparecen en tu registro de actividad, las lecturas no

Crear y revocar una clave aparecen en tu registro de actividad, igual que cada llamada a una herramienta que hace un agente por MCP. Una escritura REST también aparece — como el cambio que hizo, por ejemplo una etiqueta creada o una transacción editada. Una lectura REST no genera ninguna entrada. Era registra estas entradas en todos los planes, pero leer el registro completo requiere Organize o superior: por debajo solo ves las entradas más recientes. Las entradas de una escritura muestran tu cuenta, no la clave que hizo el cambio.

Si alguna vez dudas de una clave, revócala. Una clave que creaste tú deja de funcionar en REST y en MCP desde su siguiente petición. La clave de un agente deja de obtener acceso nuevo al instante, y cualquier token que ya tenga vence en menos de una hora. Crear otra te cuesta un minuto.

Todas las cuentas que puedes ver, en cada institución conectada, con el conteo de las que quedan fuera al lado: excludedAccountCount, dividido en tierExcludedAccountCount para las cuentas que deja fuera el límite de cuentas de tu plan y userExcludedAccountCount para las que ocultaste. accountLimit es cuántas cuentas muestra tu plan a la vez, sumando todas tus conexiones. accountLimitLift nombra el plan más barato con espacio para todas las cuentas que no ocultaste, y es null cuando tu plan no deja nada fuera. Cada cuenta lleva su accountGroupKey —el valor que el endpoint de saldo toma en su ruta— y el connectionId al que pertenece, así que esta es la primera llamada que debes hacer. Acepta connectionId para reducirlo a una sola conexión (los conteos se reducen con él; accountLimit y accountLimitLift no), e includeExcluded para incluir las cuentas que tu plan deja fuera y las que ocultaste.

{
  "accounts": [
    {
      "accountGroupKey": "uagr_7f3c9a21",
      "connectionId": "ucon_4b19e02c",
      "name": "Everyday Checking",
      "currentBalance": 4820.16,
      "supportsTransactions": true,
      …
    }
  ],
  "excludedAccountCount": 1
}

En una cuenta que has ocultado o que tu plan excluye, los campos de saldo vuelven como null y no como cero: null significa retenido, no vacío. supportsTransactions es null con el mismo sentido: quiere decir que Era no lo puede afirmar, nunca que la respuesta sea no. Lo mismo pasa con los campos del plan: si Era no pudo leer tu plan en esa llamada, tierExcludedAccountCount, userExcludedAccountCount, accountLimit y accountLimitLift vuelven todos como null. accountLimit también es null en un plan sin límite de cuentas, y accountLimitLift cuando ningún plan tiene más espacio o cuando tu plan no deja nada fuera.

One account's balance, with the credit fields filled in when the account is a liability. The path takes that account's accountGroupKey — the same value /banking/accounts returns for it. The key is not checked for shape before the lookup, so a malformed key and an unknown one answer the same way.

{
  "accountGroupKey": "uagr_7f3c9a21",
  "currentBalance": 4820.16,
  "availableBalance": 4712.03,
  "creditLimit": null,
  "currencyCode": "USD",
  "availableCredit": null,
  "asOf": "2026-08-11T09:32:00Z",
  "visibility": null
}

Una cuenta oculta, o una cuya conexión se cortó, sigue respondiendo 200, con los campos de saldo en null. Un 404 significa que la cuenta de verdad no está, o que la clave no tenía forma de clave. Fíjate aquí en el campo visibility: es null cuando la cuenta está visible, tier_excluded cuando el límite de cuentas de tu plan la deja fuera, user_excluded cuando tú la ocultaste y connection_severed cuando se cortó su conexión. Con tier_excluded, accountLimit es el límite de tu plan y accountLimitLift nombra el plan más barato con espacio para todas las cuentas que no ocultaste, esta incluida. accountLimitLift es null en cualquier otro estado, y con connection_severed accountLimit también es null.

Los totales de las cuentas que puedes ver, por defecto las reales: totalAssets, totalLiabilities y netWorthHint, que es el primero menos el segundo. Pasa simulationModes para elegir qué modos cuentan: la lista de cuentas y los totales abarcan solo los que indiques. includedSimulationModes indica qué modos abarcan, en cada respuesta. simulationExcludedAccountCount cuenta las cuentas que puedes ver y que se dejaron fuera por su modo. totalHiddenCount es una cifra aparte: las cuentas que oculta tu plan o tu propio ajuste de visibilidad, en cualquier modo, y nunca las que simulationModes dejó fuera.

{
  "userId": "7d1c0b93a8e24f60",
  "accounts": [ … ],
  "totalVisibleCount": 6,
  "totalHiddenCount": 2,
  "totalAssets": 48210.75,
  "totalLiabilities": 9327.40,
  "netWorthHint": 38883.35,
  "includedSimulationModes": [ "live" ],
  "simulationExcludedAccountCount": 0,
  "computedAt": "2026-08-11T09:32:00Z"
}

netWorthHint solo cuenta las cuentas de esta respuesta, y dos cifras te dicen lo que deja fuera. simulationExcludedAccountCount son las cuentas fuera de los modos que pediste. totalHiddenCount son las cuentas que se te ocultan en cualquier modo. Se divide en dos: tierExcludedAccountCount para las que deja fuera el límite de cuentas de tu plan, y userExcludedAccountCount para las que ocultaste tú. Ambas son null si Era no pudo leer tu plan en esa llamada. accountLimitLift nombra el plan más barato que recupera las primeras, y es null cuando no hay ninguna. Toma netWorthHint como una cifra de partida y no como tu patrimonio neto definitivo.

Tus transacciones, de página en página, envueltas junto con los conteos de paginación. Acepta page y pageSize (100 es el tope), además de filtros opcionales por cuenta, rango de fechas, reglas aplicadas y etiquetas asignadas.

{
  "transactions": [ … ],
  "pagination": {
    "currentPage": 1,
    "pageSize": 20,
    "totalItems": 412,
    "totalPages": 21
  },
  "historyWindowApplied": true,
  "historyWindowFloorDate": "2026-06-28",
  "historyWindowHiddenCount": 137,
  "historyWindowEarliestDate": "2024-03-02",
  "historyWindowDegraded": false
}

Tu plan puede aplicar un límite de ventana de historial, que oculta las transacciones más antiguas que él. Por eso la respuesta trae los campos historyWindow: historyWindowApplied te dice que el límite sí ocultó algo, historyWindowFloorDate es dónde cayó, historyWindowHiddenCount cuántas filas quedaron detrás, e historyWindowEarliestDate hasta dónde llega de verdad tu historial. Sin ellos, un resultado corto es indistinguible de una cuenta sin transacciones más antiguas. Dos de ellos cambian lo que escribes: historyWindowHiddenCount puede llegar como null aunque el límite sí se haya aplicado, así que lee null como desconocido y no como cero; y cuando historyWindowDegraded es true, Era no pudo confirmar tu plan en esa lectura, así que la fecha del límite es una suposición, no un hecho. En una lectura de pago confirmada no se aplica ningún límite y historyWindowApplied vuelve como false. El límite de cuentas de tu plan también deja transacciones fuera: tierExcludedAccountCount te dice cuántas de tus cuentas quedan fuera de esta lectura por ese límite, y userExcludedAccountCount cuántas ocultaste, las dos reducidas a la cuenta por la que filtras, si filtras por una. Las dos son null cuando Era no pudo leer tu plan en esa llamada.

Recorrer un historial largo página por página gasta solicitudes. Tu plan limita qué tan rápido puedes llamar y, en el plan gratuito, cuántas llamadas tienes al día; los planes de pago funcionan con uso razonable. En Límites están las cifras por plan, los encabezados de límite y lo que te dice un 429.

Toda la taxonomía de categorías: cada conjunto de categorías, con sus subcategorías anidadas dentro. La taxonomía es compartida, no por cuenta.

{
  "packs": [
    {
      "packSlug": "default",
      "packName": "Era default categories",
      "isDefault": true,
      "categories": [
        {
          "projectionKey": "fcat_food_dining",
          "categoryName": "Food & dining",
          "isTopLevel": true,
          "children": [ … ]
        }
      ]
    }
  ],
  "meterLimit": 25,
  "canCreateCustomCategories": true
}

Todas las etiquetas de tu cuenta, en una sola lista. Sin paginación: una sola respuesta te las devuelve todas.

{
  "tags": [
    {
      "tagKey": "utag_9c2f01ab",
      "name": "business-expense",
      "displayName": "Business expense",
      "tagType": "user",
      "color": "#6DC6BA",
      "transactionCount": 42
    }
  ]
}

Todas las reglas de automatización de tu cuenta —las que creaste y las que Era te configuró a partir de su biblioteca de reglas—, cada una con sus condiciones (filters), lo que hace (actions), si está activada y su versión. Sin paginación: una sola respuesta te las devuelve todas. Las reglas desactivadas no aparecen, a menos que las pidas.

{
  "rules": [
    {
      "id": "rule_4c1e7a90",
      "ruleName": "Coffee shops",
      "isActive": true,
      "version": 3,
      "priority": 10,
      "filters": [{ "type": "merchant_match", "pattern": "Blue Bottle", "mode": "contains" }],
      "actions": [{ "type": "set_category", "categoryKey": "fcat_coffee_shops", "categoryDisplayName": "Coffee shops" }],
      "source": "user",
      "matchedTransactionCount": 42,
      …
    }
  ]
}

filters y actions son listas de objetos tipados. Cada uno indica su tipo en un campo type —merchant_match o category entre los filtros, set_category o add_tag entre las acciones—, y el documento OpenAPI enlazado en el inicio rápido enumera todos los tipos y los campos que admite cada uno.