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. Même pour une écriture, REST ne tient aucun journal requête par requête : ce qui est noté, c'est le changement, pas l'appel, et il est inscrit sous ton compte, pas sous la clé qui l'a fait.

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 : totalAssets, totalLiabilities et netWorthHint, qui est le premier moins le second. N'accepte aucun paramètre.

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

netWorthHint ne compte que les comptes présents dans cette réponse, alors totalHiddenCount te dit ce qui lui manque : tierExcludedAccountCount d'entre eux sont laissés de côté par la limite de comptes de ton forfait, et userExcludedAccountCount, tu les as masqués toi-même. accountLimitLift nomme le forfait le moins cher qui ramène les premiers, et vaut null quand 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. 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
    }
  ]
}