API Era

Approuver un agent crée une clé

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

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

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

La création et la révocation d'une clé apparaissent toutes les deux dans votre 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, vous ne voyez que les entrées les plus récentes. Les entrées d'une écriture indiquent votre compte, pas la clé qui a fait le changement.

Si vous avez le moindre doute sur une clé, révoquez-la. Une clé que vous avez créée vous-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 prend une minute.

Tous les comptes que vous pouvez voir, dans chaque établissement connecté, avec à côté le nombre de ceux qui sont laissés de côté : excludedAccountCount, réparti entre tierExcludedAccountCount pour les comptes que la limite de comptes de votre forfait laisse de côté et userExcludedAccountCount pour ceux que vous avez masqués. accountLimit indique combien de comptes votre forfait affiche à la fois, toutes connexions confondues. accountLimitLift nomme le forfait le moins cher qui a de la place pour tous les comptes que vous n'avez pas masqués, et vaut null lorsque votre 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, c'est donc 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 votre forfait laisse de côté et ceux que vous avez masqués.

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

Sur un compte que vous avez masqué ou que votre 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. Cela veut dire qu'Era ne peut pas se prononcer, jamais que la réponse est non. Il en va de même pour les champs du forfait. Si Era n'a pas pu lire votre forfait lors de cet appel, tierExcludedAccountCount, userExcludedAccountCount, accountLimit et accountLimitLift reviennent tous à null. accountLimit vaut aussi null pour un forfait sans limite de comptes, et accountLimitLift lorsqu'aucun forfait n'offre plus de place ou que votre 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é. Surveillez le champ visibility ici — il vaut null quand le compte est visible, tier_excluded quand la limite de comptes de votre forfait le laisse de côté, user_excluded quand vous l'avez masqué, et connection_severed quand sa connexion a été coupée. Avec tier_excluded, accountLimit est la limite de votre forfait et accountLimitLift nomme le forfait le moins cher qui a de la place pour tous les comptes que vous n'avez pas masqués, celui-ci compris. accountLimitLift vaut null dans tous les autres états, et avec connection_severed, accountLimit vaut null lui aussi.

Les totaux sur les comptes que vous pouvez voir, par défaut les comptes réels : totalAssets, totalLiabilities et netWorthHint, qui est le premier moins le second. Passez simulationModes pour choisir quels modes comptent : la liste des comptes et les totaux ne couvrent que ceux que vous nommez. includedSimulationModes indique quels modes ils couvrent, dans chaque réponse. simulationExcludedAccountCount compte les comptes que vous pouvez voir et qui ont été laissés de côté à cause de leur mode. totalHiddenCount est un décompte à part : les comptes que votre offre ou votre 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 vous 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 vous sont masqués, quel que soit le mode. Il se divise en deux : tierExcludedAccountCount pour ceux que la limite de comptes de votre forfait laisse de côté, et userExcludedAccountCount pour ceux que vous avez masqués vous-même. Les deux valent null si Era n'a pas pu lire votre 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. Prenez netWorthHint comme un chiffre de départ plutôt que comme une valeur nette faisant autorité.

Vos transactions, une page à la fois, dans une enveloppe qui porte les compteurs de pagination à côté. Accepte page et pageSize (100 au maximum), plus des filtres facultatifs 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
}

Votre forfait peut appliquer un plancher de fenêtre d'historique, qui masque les transactions plus anciennes que lui. C'est pour cela que la réponse porte les champs historyWindow : historyWindowApplied vous dit qu'un plancher a bel et bien masqué quelque chose, historyWindowFloorDate indique où il tombe, historyWindowHiddenCount combien de lignes se trouvent derrière, et historyWindowEarliestDate jusqu'où votre 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 vous écrivez : historyWindowHiddenCount peut valoir null même quand un plancher s'est appliqué, alors lisez null comme une valeur inconnue plutôt que comme un zéro. Et quand historyWindowDegraded vaut true, Era n'a pas pu confirmer votre 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 votre forfait laisse aussi des transactions de côté. tierExcludedAccountCount vous dit combien de vos comptes elle tient à l'écart de cette lecture, et userExcludedAccountCount combien vous en avez masqué — les deux limités au compte sur lequel vous filtrez, le cas échéant. Les deux valent null lorsqu'Era n'a pas pu lire votre forfait lors de cet appel.

Parcourir un long historique page par page consomme des requêtes. Votre forfait plafonne la vitesse à laquelle vous pouvez appeler et, sur le forfait gratuit, le nombre d'appels par jour ; les forfaits payants fonctionnent selon un usage 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 votre compte, en une seule liste. Pas de pagination — une seule réponse les renvoie toutes.

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

Toutes les règles d'automatisation de votre compte — celles que vous avez créées et celles qu'Era a configurées pour vous à 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 les renvoie toutes. Les règles désactivées sont laissées de côté, sauf si vous les demandez.

{
  "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 son type 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 type et les champs qu'il accepte.