API Era

Approuver un agent crée une clé

Quand tu approuves un agent en OAuth, Era lui crée une clé d'API. Elle atterrit dans la même liste du tableau de bord que celles que tu crées, sous un nom qu'Era compose à partir du nom du client lui-même.

Elle porte exactement les portées que tu as approuvées sur cet écran, et rien d'autre. Révoque-la depuis le tableau de bord et l'agent ne peut plus obtenir de nouvel accès tant que tu ne l'as pas approuvé à nouveau. Un jeton qu'il détient déjà reste valable jusqu'à son expiration, une heure au plus.

Les écritures apparaissent dans ton journal d'activité, pas les lectures

Créer et révoquer une clé apparaissent tous les deux dans ton journal d'activité, tout comme chaque appel d'outil qu'un agent fait en MCP. Une écriture REST y apparaît aussi — comme le changement qu'elle a fait, une étiquette créée ou une transaction modifiée. Une lecture REST ne crée aucune entrée. Era inscrit ces entrées sur tous les forfaits, mais lire le journal complet demande Organize ou plus — en dessous, tu ne vois que les entrées les plus récentes. Les entrées d'une écriture indiquent ton compte, pas la clé qui a fait le changement.

Si jamais tu doutes d'une clé, révoque-la. Une clé que tu as créée toi-même cesse de fonctionner en REST comme en MCP dès sa requête suivante. La clé d'un agent cesse aussitôt d'obtenir de nouveaux accès, et tout jeton qu'il détient déjà expire en moins d'une heure. En refaire une te prend une minute.

Tous les comptes que tu peux voir, à travers chaque institution branchée, avec à côté le nombre de ceux qui sont laissés de côté : excludedAccountCount, séparé en tierExcludedAccountCount pour les comptes que la limite de comptes de ton forfait laisse de côté et userExcludedAccountCount pour ceux que tu as masqués. accountLimit, c'est le nombre de comptes que ton forfait montre à la fois, toutes connexions confondues. accountLimitLift nomme le forfait le moins cher qui a de la place pour tous les comptes que tu n'as pas masqués, et vaut null quand ton forfait ne laisse rien de côté. Chaque compte porte son accountGroupKey — la valeur que le point de terminaison de solde prend dans son chemin — et le connectionId auquel il appartient, alors c'est le premier appel à faire. Accepte connectionId pour se limiter à une seule connexion (les nombres se limitent avec lui, accountLimit et accountLimitLift non), et includeExcluded pour ramener les comptes que ton forfait laisse de côté et ceux que tu as masqués.

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

Sur un compte que tu as masqué ou que ton forfait exclut, les champs de solde reviennent à null plutôt qu'à zéro — null veut dire retenu, pas vide. supportsTransactions vaut null dans le même esprit : ça veut dire qu'Era ne peut pas se prononcer, jamais que la réponse est non. Même chose pour les champs du forfait : si Era n'a pas pu lire ton forfait sur cet appel, tierExcludedAccountCount, userExcludedAccountCount, accountLimit et accountLimitLift reviennent tous à null. accountLimit vaut aussi null sur un forfait sans limite de comptes, et accountLimitLift quand aucun forfait n'a plus de place ou quand ton forfait ne laisse rien de côté.

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
}

Un compte masqué, ou un compte dont la connexion a été coupée, répond quand même 200 — avec les champs de solde à null. Un 404 signifie que le compte n'existe vraiment pas, ou que la clé n'avait pas la forme d'une clé. Surveille le champ visibility ici : il vaut null quand le compte est visible, tier_excluded quand la limite de comptes de ton forfait le laisse de côté, user_excluded quand tu l'as masqué, et connection_severed quand sa connexion a été coupée. Avec tier_excluded, accountLimit est la limite de ton forfait et accountLimitLift nomme le forfait le moins cher qui a de la place pour tous les comptes que tu n'as pas masqués, celui-ci compris. accountLimitLift vaut null dans tous les autres états, et avec connection_severed, accountLimit vaut null aussi.

Les totaux sur les comptes que tu peux voir, par défaut les comptes réels : totalAssets, totalLiabilities et netWorthHint, qui est le premier moins le second. Passe simulationModes pour choisir quels modes comptent : la liste des comptes et les totaux ne couvrent que ceux que tu nommes. includedSimulationModes indique quels modes ils couvrent, dans chaque réponse. simulationExcludedAccountCount compte les comptes que tu peux voir et qui ont été laissés de côté à cause de leur mode. totalHiddenCount est un décompte à part : les comptes que ton offre ou ton propre réglage de visibilité masque, quel que soit le mode, et jamais ceux que simulationModes a laissés de côté.

{
  "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 ne compte que les comptes présents dans cette réponse, et deux décomptes te disent ce qu'il laisse de côté. simulationExcludedAccountCount, ce sont les comptes en dehors des modes demandés. totalHiddenCount, ce sont les comptes qui te sont masqués, quel que soit le mode. Il se divise en deux : tierExcludedAccountCount pour ceux que la limite de comptes de ton forfait laisse de côté, et userExcludedAccountCount pour ceux que tu as masqués toi-même. Les deux valent null si Era n'a pas pu lire ton forfait lors de cet appel. accountLimitLift nomme le forfait le moins cher qui ramène les premiers, et vaut null lorsqu'il n'y en a aucun. Prends netWorthHint comme un chiffre de départ plutôt que comme une valeur nette faisant autorité.

Tes transactions, une page à la fois, enveloppées avec les compteurs de pagination à côté. Accepte page et pageSize (100 au maximum), plus des filtres optionnels par compte, plage de dates, règles appliquées et étiquettes assignées.

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

Ton forfait peut appliquer un plancher de fenêtre d'historique, qui cache les transactions plus anciennes que lui. C'est pour ça que la réponse porte les champs historyWindow : historyWindowApplied te dit qu'un plancher a bel et bien caché quelque chose, historyWindowFloorDate indique où il tombe, historyWindowHiddenCount combien de lignes sont derrière, et historyWindowEarliestDate jusqu'où ton historique remonte vraiment. Sans eux, un résultat court est impossible à distinguer d'un compte sans transactions plus anciennes. Deux d'entre eux changent ce que tu écris : historyWindowHiddenCount peut valoir null même quand un plancher s'est appliqué, alors lis null comme une valeur inconnue plutôt que comme un zéro; et quand historyWindowDegraded vaut true, Era n'a pas pu confirmer ton forfait sur cette lecture, donc la date du plancher est une supposition et non un fait. Sur une lecture payante confirmée, aucun plancher ne s'applique et historyWindowApplied revient à false. La limite de comptes de ton forfait laisse aussi des transactions de côté : tierExcludedAccountCount te dit combien de tes comptes elle garde hors de cette lecture, et userExcludedAccountCount combien tu en as masqué — les deux limités au compte sur lequel tu filtres, si tu en filtres un. Les deux valent null quand Era n'a pas pu lire ton forfait sur cet appel.

Parcourir un long historique page par page consomme des requêtes. Ton forfait plafonne la vitesse à laquelle tu peux appeler et, sur le forfait gratuit, le nombre d'appels par jour; les forfaits payants fonctionnent selon une utilisation raisonnable. Limites donne les chiffres par forfait, les en-têtes de limite et ce que dit un 429.

Toute la taxonomie des catégories : chaque ensemble de catégories, avec ses sous-catégories imbriquées dedans. La taxonomie est partagée, pas propre à un compte.

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

Toutes les étiquettes de ton compte, en une seule liste. Pas de pagination — une seule réponse te les retourne toutes.

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

Toutes les règles d'automatisation de ton compte — celles que tu as créées et celles qu'Era a configurées pour toi à partir de sa bibliothèque de règles — chacune avec ses conditions (filters), ce qu'elle fait (actions), si elle est activée, et sa version. Pas de pagination : une seule réponse te les retourne toutes. Les règles désactivées sont laissées de côté, sauf si tu les demandes.

{
  "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 et actions sont des listes d'objets typés. Chacun indique sa sorte dans un champ type — merchant_match ou category parmi les filtres, set_category ou add_tag parmi les actions — et le document OpenAPI lié dans le démarrage rapide liste chaque sorte et les champs qu'elle prend.