Era-API

Einen Agenten freizugeben erzeugt einen Schlüssel

Wenn du einen Agenten per OAuth freigibst, erstellt Era ihm einen API-Schlüssel. Er landet in derselben Dashboard-Liste wie die, die du selbst anlegst, unter einem Namen, den Era aus dem Namen des Clients bildet.

Er trägt genau die Scopes, die du auf diesem Bildschirm freigegeben hast, und sonst nichts. Widerrufe ihn im Dashboard, und der Agent bekommt keinen neuen Zugriff, bis du ihn erneut freigibst. Ein Token, das er schon hat, funktioniert weiter, bis es abläuft — höchstens eine Stunde.

Schreibzugriffe stehen in deinem Aktivitätsprotokoll, Lesezugriffe nicht

Das Erstellen und das Widerrufen eines Schlüssels stehen beide in deinem Aktivitätsprotokoll, ebenso jeder Tool-Aufruf, den ein Agent über MCP macht. Ein REST-Schreibzugriff steht ebenfalls darin — als die Änderung, die er gemacht hat, etwa ein angelegter Tag oder eine bearbeitete Transaktion. Ein REST-Lesezugriff erzeugt überhaupt keinen Eintrag. Era schreibt diese Einträge in jedem Tarif mit, aber um das vollständige Protokoll zu lesen, brauchst du Organize oder höher — darunter siehst du nur die neuesten Einträge. Auch beim Schreiben führt REST kein Protokoll pro Request: festgehalten wird die Änderung, nicht der Aufruf, und sie steht unter deinem Konto, nicht unter dem Schlüssel, der sie gemacht hat.

Wenn du dir bei einem Schlüssel je unsicher bist, widerrufe ihn. Ein selbst erstellter Schlüssel funktioniert ab seiner nächsten Anfrage nicht mehr, auf REST wie auf MCP. Der Schlüssel eines Agenten bekommt sofort keinen neuen Zugriff mehr, und ein Token, das er schon hat, läuft innerhalb einer Stunde ab. Ein Ersatz ist in einer Minute erstellt.

Jedes Konto, das du sehen kannst, über alle verbundenen Banken hinweg, und daneben die Zahl der ausgelassenen: excludedAccountCount, aufgeteilt in tierExcludedAccountCount für die Konten, die das Kontolimit deines Tarifs auslässt, und userExcludedAccountCount für die, die du ausgeblendet hast. accountLimit ist, wie viele Konten dein Tarif gleichzeitig zeigt, über alle deine Verbindungen hinweg. accountLimitLift nennt den günstigsten Tarif, der Platz für jedes Konto hat, das du nicht ausgeblendet hast, und ist null, wenn dein Tarif nichts auslässt. Jedes Konto trägt seinen accountGroupKey — den Wert, den der Salden-Endpunkt in seinem Pfad nimmt — und die connectionId, zu der es gehört, deshalb ist das der erste Aufruf. Nimmt connectionId, um auf eine einzelne Verbindung einzugrenzen (die Zahlen grenzen sich mit ein, accountLimit und accountLimitLift nicht), und includeExcluded, um die Konten hereinzuholen, die dein Tarif auslässt, und die, die du ausgeblendet hast.

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

Bei einem Konto, das du ausgeblendet hast oder das dein Tarif ausschließt, kommen die Saldenfelder als null zurück und nicht als Null — null heißt zurückgehalten, nicht leer. supportsTransactions ist null im selben Sinn: Era kann es nicht sagen, und nie heißt es, die Antwort sei nein. Genauso bei den Tariffeldern: Wenn Era deinen Tarif bei dieser Anfrage nicht lesen konnte, kommen tierExcludedAccountCount, userExcludedAccountCount, accountLimit und accountLimitLift alle als null zurück. accountLimit ist außerdem null bei einem Tarif ohne Kontolimit, und accountLimitLift, wenn kein Tarif mehr Platz hat oder dein Tarif nichts auslässt.

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
}

Ein ausgeblendetes Konto, oder eines, dessen Verbindung gekappt wurde, antwortet trotzdem mit 200 — mit den Saldenfeldern auf null. Ein 404 heißt, dass es das Konto wirklich nicht gibt oder der Schlüssel nicht die Form eines Schlüssels hatte. Achte hier auf das Feld visibility: Es ist null, wenn das Konto sichtbar ist, tier_excluded, wenn das Kontolimit deines Tarifs es auslässt, user_excluded, wenn du es ausgeblendet hast, und connection_severed, wenn seine Verbindung gekappt wurde. Bei tier_excluded ist accountLimit das Limit deines Tarifs, und accountLimitLift nennt den günstigsten Tarif, der Platz für jedes Konto hat, das du nicht ausgeblendet hast, dieses eingeschlossen. Bei jedem anderen Zustand ist accountLimitLift null, und bei connection_severed ist auch accountLimit null.

Summen über die Konten, die du sehen kannst: totalAssets, totalLiabilities und netWorthHint, also das erste minus dem zweiten. Nimmt keine Parameter.

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

netWorthHint zählt nur die Konten in dieser Antwort, deshalb sagt dir totalHiddenCount, was ihm fehlt: tierExcludedAccountCount davon lässt das Kontolimit deines Tarifs aus, und userExcludedAccountCount hast du selbst ausgeblendet. accountLimitLift nennt den günstigsten Tarif, der die erste Sorte zurückholt, und ist null, wenn es keine gibt. Nimm netWorthHint als Ausgangszahl und nicht als verbindliches Nettovermögen.

Deine Transaktionen, seitenweise, eingepackt zusammen mit den Seitenzahlen. Nimmt page und pageSize (100 ist die Obergrenze), dazu optionale Filter nach Konto, Zeitraum, angewendeten Regeln und vergebenen Tags.

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

Dein Tarif kann eine Verlaufsfenster-Grenze anwenden, die ältere Transaktionen verbirgt. Deshalb trägt die Antwort die historyWindow-Felder: historyWindowApplied sagt dir, dass eine Grenze tatsächlich etwas verborgen hat, historyWindowFloorDate, wo sie liegt, historyWindowHiddenCount, wie viele Zeilen dahinter stehen, und historyWindowEarliestDate, wie weit dein Verlauf wirklich zurückreicht. Ohne sie ist ein kurzes Ergebnis nicht von einem Konto ohne ältere Transaktionen zu unterscheiden. Zwei davon ändern, was du schreibst: historyWindowHiddenCount kann null sein, auch wenn eine Grenze gegriffen hat — lies null also als unbekannt und nicht als die Zahl 0; und wenn historyWindowDegraded true ist, konnte Era deinen Tarif bei dieser Anfrage nicht bestätigen, das Grenzdatum ist dann eine Schätzung und keine Tatsache. Bei einer bestätigten bezahlten Anfrage greift keine Grenze, und historyWindowApplied kommt als false zurück. Auch das Kontolimit deines Tarifs lässt Transaktionen aus: tierExcludedAccountCount sagt, wie viele deiner Konten es aus dieser Anfrage heraushält, und userExcludedAccountCount, wie viele du ausgeblendet hast — beide auf das Konto eingegrenzt, nach dem du gefiltert hast, falls du das getan hast. Beide sind null, wenn Era deinen Tarif bei dieser Anfrage nicht lesen konnte.

Durch eine lange Historie zu blättern verbraucht Anfragen. Dein Tarif begrenzt, wie schnell du aufrufen kannst, und im kostenlosen Tarif, wie viele Aufrufe du pro Tag bekommst. Unter Limits stehen die Zahlen pro Tarif, die Rate-Limit-Header und was ein 429 dir sagt.

Die gesamte Kategorien-Taxonomie: jede Kategoriengruppe, mit ihren Unterkategorien darin verschachtelt. Die Taxonomie ist gemeinsam, nicht pro Konto.

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

Alle Tags deines Kontos, als eine Liste. Keine Seitenaufteilung — eine Antwort gibt dir alle zurück.

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