Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.methodfi.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Account Lifecycle and Status

Accounts move through a defined set of statuses that reflect their current state:
StatusDescription
ActiveThe account is fully connected, verified (if applicable), and ready for use. All supported products are available. This is the normal operating state for most accounts.
ProcessingThe account is being set up or verified. For liability accounts, this may be a brief transitional state during discovery. For funding accounts, this typically means verification is in progress (e.g., waiting for micro-deposit confirmation).
DisabledThe account has been deactivated within Method. The account may still be active at the financial institution, but Method will not perform new operations on it. This can happen if the account is flagged for an issue or explicitly disabled by your team.
ClosedMethod has detected that the account is closed at the financial institution. The debt may have been paid off, the card may have been canceled, or the loan may have been settled. No new operations are available, but historical data remains accessible.
Common causes of Disabled status: the Entity’s consent was withdrawn, the Entity’s verification expired or was revoked, the account was flagged by Method’s risk monitoring, or your team explicitly disabled it via the API. Check the account’s error field for the specific reason.

​
State Transitions

  • Processing → Active: Account setup or verification completes successfully
  • Active → Disabled: Account is flagged for an issue or explicitly disabled. May be reversible — listen for account.active webhooks
  • Active → Closed: Method detects the account is closed at the financial institution (debt paid off, card canceled, loan settled)
  • Disabled → Active: The issue is resolved and the account is re-enabled
  • Closed is terminal — closed accounts do not reopen
Webhook tip: Subscribe to account.active, account.disabled, and account.closed webhook events to handle transitions in real time rather than polling.

​
Key Webhooks

  • account.active: Account transitioned to Active
  • account.disabled: Account was disabled
  • account.closed: Account was closed
  • account.update.completed: An Update finished (balance/data refreshed)

​
Subscriptions: Automatic Data Refresh

Instead of manually requesting Updates or Balances, you can subscribe an account to automatic refresh. When subscribed, Method periodically fetches fresh data and notifies you via webhook. See Update Subscriptions for details. The subscriptions and available_subscriptions arrays on each Account show what’s currently active and what can be enabled.

​
Products and the Lifecycle

Each account carries a products array — the list of Method capabilities currently available for that account. Products include: update (refresh balances/data), balance (real-time balance), payment (send funds to creditor), card_brand (card art and product name), payoff (auto loan payoff quotes), sensitive (full account numbers), attribute (credit health metrics), and payment_instrument (card tokenization). Product availability depends on three factors:
  1. Account type: card_brand only applies to credit cards, payoff only to auto loans (see Liability Types)
  2. Account status: Disabled and Closed accounts lose most products
  3. Team configuration: Some products require team-level enablement (check restricted_products)
Always check the products array before attempting an operation. Attempting an operation not in products will return an error. See the Products reference for the full list.