Skip to main content
GET
/
accounts
curl "https://production.methodfi.com/accounts?holder_id=ent_y1a9e1fbnJ1f3&type=liability&status=active" \
  -H "Method-Version: 2025-07-04" \
  -H "Authorization: Bearer sk_WyZEWVfTcH7GqmPzUPk65Vjc"

{
  "data": [
    {
      "id": "acc_RGACQH7XdfYhC",
      "holder_id": "ent_y1a9e1fbnJ1f3",
      "status": "active",
      "type": "liability",
      "liability": {
        "mch_id": "mch_302086",
        "mask": "1580",
        "ownership": "primary",
        "fingerprint": "27d5c0ea28338619192076d150eb7b56c288f9a1",
        "type": "credit_card",
        "name": "Chase Sapphire Reserve Credit Card"
      },
      "latest_verification_session": "avf_tB9mpmew8FLit",
      "update": "upt_TXDTR7Amyz7Az",
      "balance": "bal_dGCCNWHMQYRay",
      "card_brand": "crd_eVMDNUPfrFk3e",
      "payment_instrument": "pmt_inst_pd788hPVhLT37",
      "products": ["balance", "card_brand", "update", "payment", "payment_instrument"],
      "restricted_products": ["attribute", "sensitive"],
      "subscriptions": [],
      "available_subscriptions": ["update.snapshot", "update"],
      "restricted_subscriptions": ["transaction"],
      "error": null,
      "metadata": null,
      "created_at": "2024-04-12T18:57:57.857Z",
      "updated_at": "2024-04-12T18:57:58.430Z",
    }
  ]
}
Returns a list of Accounts.

​
Query Parameters

​
holder_id
string
The ID of the Entity whose Accounts to retrieve.
​
status
enum
Status of the Account.
active
The Account is open and is in a usable state.disabled
The Account has been disabled and is no longer usable. Check the account's error property for more information.closed
The Account has been closed, and is either fully paid-off or no longer exists.
​
type
enum
The type of Account.
ach
A bank account (Checking or Savings).liability
A debt-type account (Credit Card, Mortgage, etc).
​
liability.mch_id
string
The ID of the Merchant to which a liability Account is linked.
​
liability.type
enum
The type of the liability Account to retrieve. See Account Liability Types.
​
liability.sub_type
enum
The sub-type of the liability Account to retrieve. See Account Liability Sub-Types.
​
liability.ownership
enum
The holder's ownership type relative to the Account. One of primary, authorized, joint or unknown
​
from_date
string
ISO 8601 formatted date (YYYY-MM-DD) to filter for Accounts created on and after the date provided.
​
to_date
string
ISO 8601 formatted date (YYYY-MM-DD) to filter for Accounts created on and before the date provided.
​
page
string
The number of the page to return.
​
page_cursor
string
The ID of a resource from which a page should start or end. Mutually exclusive with page.
​
page_limit
string
The number of Accounts to return per page. The default (and maximum) is 100 records.
​
expand
enum[]
Attributes that can be expanded into an object to provide additional information.
sensitive
This is an Account property, and refers to the Sensitive Object.balance
This is an Account property, and refers to the Balance Object.card_brand
This is an Account property, and refers to the CardBrand Object.attribute
This is an Account property, and refers to the Attribute Object.payoff
This is an Account property, and refers to the Payoff Object.transaction
This is an Account property, and refers to the Transaction Object.update
This is an Account property, and refers to the Update Object.payment_instrument
This is an Account property, and refers to the PaymentInstrument Object.latest_verification_session
This is an Account property, and refers to the AccountVerificationSession Object.

​
Returns

Returns a list of Accounts. 
curl "https://production.methodfi.com/accounts?holder_id=ent_y1a9e1fbnJ1f3&type=liability&status=active" \
  -H "Method-Version: 2025-07-04" \
  -H "Authorization: Bearer sk_WyZEWVfTcH7GqmPzUPk65Vjc"

{
  "data": [
    {
      "id": "acc_RGACQH7XdfYhC",
      "holder_id": "ent_y1a9e1fbnJ1f3",
      "status": "active",
      "type": "liability",
      "liability": {
        "mch_id": "mch_302086",
        "mask": "1580",
        "ownership": "primary",
        "fingerprint": "27d5c0ea28338619192076d150eb7b56c288f9a1",
        "type": "credit_card",
        "name": "Chase Sapphire Reserve Credit Card"
      },
      "latest_verification_session": "avf_tB9mpmew8FLit",
      "update": "upt_TXDTR7Amyz7Az",
      "balance": "bal_dGCCNWHMQYRay",
      "card_brand": "crd_eVMDNUPfrFk3e",
      "payment_instrument": "pmt_inst_pd788hPVhLT37",
      "products": ["balance", "card_brand", "update", "payment", "payment_instrument"],
      "restricted_products": ["attribute", "sensitive"],
      "subscriptions": [],
      "available_subscriptions": ["update.snapshot", "update"],
      "restricted_subscriptions": ["transaction"],
      "error": null,
      "metadata": null,
      "created_at": "2024-04-12T18:57:57.857Z",
      "updated_at": "2024-04-12T18:57:58.430Z",
    }
  ]
}