Era-API

Een agent goedkeuren maakt een sleutel

Wanneer je een agent via OAuth goedkeurt, maakt Era een API-sleutel voor die agent. Die komt in dezelfde lijst in het dashboard als de sleutels die je zelf maakt, onder een naam die Era afleidt van de naam van de client zelf.

Hij heeft precies de bereiken die je op dat scherm hebt goedgekeurd, en niets anders. Trek hem in vanuit het dashboard en de agent kan geen nieuwe toegang meer krijgen totdat je opnieuw goedkeurt. Een token die hij al heeft, blijft werken totdat hij verloopt, maximaal een uur.

Schrijfacties verschijnen in je activiteitenlogboek, leesacties niet

Het maken en intrekken van een sleutel verschijnen allebei in je activiteitenlogboek, net als elke toolaanroep die een agent via MCP doet. Ook een REST-schrijfactie wordt vastgelegd, als de wijziging die hij deed, zoals een aangemaakte tag of een bewerkte transactie. Een REST-leesactie maakt geen vermelding aan. Era legt deze vermeldingen vast bij elk abonnement, maar het lezen van het volledige logboek vereist Organize of hoger: daaronder zie je alleen de meest recente. De vermelding van een schrijfactie noemt je account, niet de sleutel waarmee de wijziging is gedaan.

Als je ooit twijfelt over een sleutel, trek hem dan in. Een sleutel die je zelf hebt gemaakt, werkt vanaf zijn volgende verzoek niet meer op REST en MCP. De sleutel van een agent krijgt meteen geen nieuwe toegang meer, en een token die hij al heeft, verloopt binnen een uur. Een vervanger maken kost een minuut.

Elke rekening die je kunt zien, over elke gekoppelde instelling, met het aantal rekeningen dat ontbreekt ernaast: excludedAccountCount, uitgesplitst in tierExcludedAccountCount voor de rekeningen die de limiet voor live gegevenskoppelingen van je abonnement buiten houdt, holdingsTierExcludedAccountCount voor de beleggingsrekeningen die de limiet voor beleggingsrekeningen van je abonnement buiten houdt, en userExcludedAccountCount voor die je op elk abonnement opnieuw kunt tonen: die je hebt verborgen, en elke handmatige rekening die nog verborgen is van voordat handmatige rekeningen niet meer meetelden voor de limiet. accountLimit is hoeveel rekeningen die door een live gegevenskoppeling worden gevoed je abonnement tegelijk toont, over al je koppelingen. Handmatige rekeningen en beleggingsrekeningen tellen daar niet voor mee. holdingsLimit is hoeveel beleggingsrekeningen je abonnement tegelijk toont, en 0 betekent dat je abonnement er geen bevat. accountLimitLift noemt het goedkoopste abonnement met ruimte voor elke rekening die meetelt voor accountLimit en die je niet hebt verborgen, en is null wanneer die limiet niets buiten houdt. Elke rekening heeft zijn accountGroupKey, de waarde die het saldo-endpoint in zijn pad neemt, en de connectionId waar hij bij hoort, dus dit is de aanroep om eerst te doen. Neemt connectionId om te beperken tot één koppeling (de aantallen worden meebeperkt; accountLimit, holdingsLimit en accountLimitLift niet), includeExcluded om de rekeningen mee te nemen die je abonnement buiten houdt en die je hebt verborgen, en includeSevered om de rekeningen mee te nemen van koppelingen die je hebt ontkoppeld. De archive van elke rekening zegt of hij is gearchiveerd en waarom; archiveren verandert hoe een rekening wordt weergegeven, nooit een saldo of een aantal.

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

Een null-saldo is nooit nul, en visibility zegt wat het betekent. Bij een rekening die je hebt verborgen (userExcluded) of die je abonnement buiten houdt (tierExcluded), komen de saldovelden als null terug omdat het saldo wordt achtergehouden, niet leeg is. Bij een zichtbare rekening betekent een null-currentBalance dat de provider nooit een saldo meldde, en supportsBalances zegt of dit soort rekening überhaupt een saldo meldt. Een saldo dat de provider als nul opgaf, komt nog steeds als 0 terug. supportsTransactions is null in dezelfde geest: het betekent dat Era het niet kan zeggen, en nooit dat het antwoord nee is. Hetzelfde geldt voor de abonnementsvelden: als Era je abonnement bij die aanroep niet kon lezen, komen tierExcludedAccountCount, holdingsTierExcludedAccountCount, userExcludedAccountCount, accountLimit, holdingsLimit en accountLimitLift allemaal als null terug. accountLimit is ook null bij een abonnement zonder limiet voor live gegevenskoppelingen, holdingsLimit bij een abonnement zonder limiet voor beleggingsrekeningen of wanneer Era die ruimte niet kon vaststellen, en accountLimitLift wanneer geen abonnement meer ruimte heeft of wanneer de limiet voor live gegevenskoppelingen van je abonnement niets buiten houdt.

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
}

Een verborgen rekening, of een waarvan de koppeling is verbroken, antwoordt nog steeds 200, met de saldovelden als null. Een 404 betekent dat de rekening er echt niet is, of dat de sleutel niet zo gevormd was. Let hier op het veld visibility: het is null wanneer de rekening zichtbaar is, tier_excluded wanneer een van de limieten van je abonnement hem buiten houdt, user_excluded wanneer je hem hebt verborgen, en connection_severed wanneer zijn koppeling is verbroken. Bij een tier_excluded-rekening die meetelt voor de limiet voor live gegevenskoppelingen van je abonnement, is accountLimit die limiet en noemt accountLimitLift het goedkoopste abonnement met ruimte voor elke zulke rekening die je niet hebt verborgen, deze meegerekend. accountLimitLift is null bij een handmatige rekening, een beleggingsrekening en elke andere toestand, en bij connection_severed is accountLimit ook null. Bij een zichtbare rekening (visibility null) betekent een null-currentBalance dat er geen saldo is gemeld, nooit nul. supportsBalances, op de rij van de rekening in de lijst met rekeningen, zegt of dit soort rekening überhaupt een saldo meldt.

Totalen over de rekeningen die je kunt zien, standaard live: totalAssets, totalLiabilities en netWorthHint, het eerste min het tweede. Geef simulationModes mee om te kiezen welke modi meetellen: de lijst met rekeningen en de totalen dekken alleen de modi die je noemt. includedSimulationModes zegt welke modi ze dekken, bij elk antwoord. simulationExcludedAccountCount telt de rekeningen die je kunt zien en die vanwege hun modus zijn weggelaten. totalHiddenCount is een apart aantal: de rekeningen die je abonnement of je eigen zichtbaarheidsinstelling verbergt, in elke modus, en nooit die simulationModes wegliet.

{
  "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 telt alleen de rekeningen in dit antwoord, en twee aantallen vertellen wat het weglaat. simulationExcludedAccountCount zijn de rekeningen buiten de modi waar je om vroeg. totalHiddenCount zijn de rekeningen die voor jou verborgen zijn in elke modus. Het splitst in drie: tierExcludedAccountCount voor die de limiet voor live gegevenskoppelingen van je abonnement buiten houdt, holdingsTierExcludedAccountCount voor de beleggingsrekeningen die de limiet voor beleggingsrekeningen van je abonnement buiten houdt, en userExcludedAccountCount voor die je op elk abonnement opnieuw kunt tonen. Alle drie zijn null als Era je abonnement bij die aanroep niet kon lezen. accountLimitLift noemt het goedkoopste abonnement dat het eerste soort terugbrengt, en is null als er geen zijn. Een rekening waarvan het saldo niet is gemeld, staat nog steeds in de lijst, maar voegt niets toe aan de totalen. Behandel netWorthHint als een beginwaarde en niet als een gezaghebbend vermogen.

Je transacties, een pagina tegelijk, verpakt in een envelop met de pagineringsaantallen ernaast. Neemt page en pageSize (100 is het maximum), plus optionele filters voor rekening, periode, toegepaste regels en toegewezen 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
}

Er is geen aanroep die één transactie leest op basis van zijn id. GET /banking/transactions/{id} antwoordt 405 met Allow: PUT, omdat dat pad een transactie alleen wijzigt. Om er een te lezen, lijst je met filters die tot die ene beperken: accountId ingesteld op de accountGroupKey, fromDate en toDate allebei op de transactionDate, en search op de handelaarsnaam of het bedrag. Zoek hem daarna op zijn id in wat terugkomt. Voeg includePending toe als het een recente afschrijving in behandeling is.

Je abonnement kan een ondergrens voor het geschiedenisvenster toepassen, die transacties verbergt die ouder zijn. Daarom bevat het antwoord de historyWindow-velden: historyWindowApplied zegt dat een ondergrens echt iets verborg, historyWindowFloorDate is waar die lag, historyWindowHiddenCount is hoeveel rijen erachter zitten en historyWindowEarliestDate is hoe ver je geschiedenis echt teruggaat. Zonder deze velden is een korte resultatenset niet te onderscheiden van een rekening zonder oudere transacties. Twee ervan veranderen wat je schrijft: historyWindowHiddenCount kan null zijn, ook als een ondergrens gold, dus lees null als onbekend en niet als nul; en als historyWindowDegraded true is, kon Era je abonnement bij die leesactie niet bevestigen, dus de datum van de ondergrens is een gok en geen feit. Bij een bevestigde betaalde leesactie geldt er geen ondergrens en komt historyWindowApplied als false terug. De limieten van je abonnement laten ook transacties weg: tierExcludedAccountCount is hoeveel van je rekeningen de limiet op live gegevenskoppelingen buiten deze leesactie houdt, holdingsTierExcludedAccountCount hoeveel van je beleggingsrekeningen de limiet voor beleggingsrekeningen buiten houdt, en userExcludedAccountCount hoeveel je op elk abonnement opnieuw kunt tonen. Alle drie zijn beperkt tot de rekening waarop je filterde, als dat zo is. Alle drie zijn null wanneer Era je abonnement bij die aanroep niet kon lezen.

Door een lange geschiedenis heen pagineren kost verzoeken. Je abonnement bepaalt hoe snel je kunt aanroepen en, bij het gratis abonnement, hoeveel aanroepen je per dag krijgt; betaalde abonnementen draaien op redelijk gebruik. Limieten bevat de cijfers per abonnement, de rate-limit-headers en wat een 429 je vertelt.

De hele categorietaxonomie: elke set categorieën, met de subcategorieën erin genest. De taxonomie wordt gedeeld, niet per rekening.

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

Elke tag op je account, als één lijst. Geen paginering: één antwoord geeft ze allemaal terug.

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

De afschrijvingen, facturen en inkomsten die in je transacties terugkeren, grootste estimatedAmount eerst. De lijst komt van een van twee plekken. Zodra Era terugkerende patronen in je transacties heeft gedetecteerd, somt hij die op, elk met confidence system. Tot dan groepeert hij de recente transacties die de gegevens van je bank als terugkerend markeren, een abonnement, een factuurbetaling of inkomsten, per handelaar en valuta, elke groep met confidence provider. Elk item heeft de handelaar; estimatedAmount, het gebruikelijke bedrag per keer, nooit negatief, welke kant het geld ook op gaat; frequency, de schatting van Era hoe vaak het terugkeert; category, dat null is als er geen is en altijd null voor een patroon dat Era detecteerde; lastSeen, de datum van de laatste transactie, of bij een patroon dat Era detecteerde, de datum waarop het werd gedetecteerd; type; en confidence. type is subscription, bill of income waar de gegevens van je bank zeggen welke, en recurring waar ze dat niet zeggen, wat elk patroon is dat Era detecteerde. Dus bij een item met type recurring zegt niets of het geld binnenkomt of uitgaat. Afschrijvingen in behandeling blijven buiten beschouwing. Neemt geen parameters en negeert alles wat je meestuurt.

{
  "items": [
    {
      "merchant": "Netflix",
      "estimatedAmount": { "amount": 15.49, "currency": "USD", … },
      "frequency": "monthly",
      "category": "Entertainment",
      "lastSeen": "2026-09-28",
      "type": "subscription",
      "confidence": "provider"
    },
    …
  ]
}

Geld erin en geld eruit over één periode: inkomsten, uitgaven en netto, dat is het eerste min het tweede, met de categorieën achter elke kant: incomeCategories en expenseCategories, grootste eerst, elk met zijn bedrag, zijn aandeel in het totaal van die kant en hoeveel transacties erin zitten. Overboekingen tussen je rekeningen, afschrijvingen in behandeling, en transacties die je hebt verborgen of die op rekeningen staan die je hebt verborgen of die de limiet voor live gegevenskoppelingen van je abonnement buiten houdt, blijven buiten beschouwing; excludedAccountCount telt die rekeningen. income en expense tellen elke categorie aan hun kant, ook elke categorie die topN van de lijst laat, dus de categorieën die je terugkrijgt kunnen samen minder zijn dan het totaal van hun kant; elke percentOfTotal is een aandeel van dat volledige totaal. De periode waar je om vroeg komt terug met zijn begin, einde en een leesbaar label; een venster komt terug met zijn sleutel in period.window en de tijdzone die bepaalde wat vandaag is in period.timeZone. Wanneer incomePercentOfTotalUnavailable of expensePercentOfTotalUnavailable true is, zijn de percentOfTotal-waarden van die kant 0 omdat het aandeel niet kon worden berekend, niet omdat de categorie 0% ervan is: lees ze als ontbrekend. Elke categorie en subcategorie heeft ook displayOrder, zijn plaats in je eigen categorielijst vanaf 0, dus sorteren erop toont ze in de volgorde waarin je ze bewaart; het is null voor ongecategoriseerd geld, voor een categorie die je lijst niet toont, en voor elke categorie wanneer je categorielijst niet kon worden gelezen. Standaard deze maand.

{
  "period": { "period": "last_month", "start": "2026-09-01", "end": "2026-09-30", "label": "September 2026", "window": null, "timeZone": null },
  "income": { "amount": 5200.00, "currency": "USD", … },
  "expense": { "amount": 4000.00, "currency": "USD", … },
  "net": { "amount": 1200.00, "currency": "USD", … },
  "incomeCategories": [ … ],
  "expenseCategories": [
    {
      "label": "Groceries",
      "categoryKey": "fcat_groceries",
      "amount": { "amount": 600.00, "currency": "USD", … },
      "percentOfTotal": 15,
      "transactionCount": 14,
      "displayOrder": 3,
      "children": null
    },
    …
  ],
  "excludedAccountCount": 0,
  "excludedAccountNote": null,
  "incomePercentOfTotalUnavailable": false,
  "expensePercentOfTotalUnavailable": false
}

Elke automatiseringsregel op je account: die je zelf maakte en die Era voor je instelde uit zijn regelbibliotheek. Elk met zijn voorwaarden (filters), wat hij doet (acties), of hij aanstaat en zijn versie. Geen paginering: één antwoord geeft ze allemaal terug. Uitgeschakelde regels blijven weg, tenzij je erom vraagt.

{
  "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 en actions zijn lijsten van getypeerde objecten. Elk noemt zijn soort in een type-veld: merchant_match of category onder de filters, set_category of add_tag onder de acties. Het OpenAPI-document waarnaar de snelstart linkt, somt elke soort op en de velden die hij neemt.