---
title: "List Accounts"
method: GET
path: "/accounts"
tags: ["Accounts"]
---

# List Accounts

`GET /accounts`

## Request

- Base URL: `https://api.finta.io/v1`
- URL: `https://api.finta.io/v1/accounts`
- Auth: HTTP bearer

Returns all accounts with current balances for the authenticated user, aggregating data from all connected providers (Plaid, GoCardless, Stripe, Mercury).

## Query parameters

- `connectionId` string, uuid

## Response `200`

List of accounts

- AccountsListResponse
  - `data` Account[], required: List of accounts
    - `id` string, required: Unique identifier for the account from the provider
    - `bankConnectionId` string, uuid, required: ID of the bank connection this account belongs to
    - `name` string, required: Name of the account (e.g., 'Chase Checking')
    - `balance` Balance, required
      - `current` number, nullable, required: Current balance of the account
      - `available` number, nullable, required: Available balance (for depository accounts, amount available to spend; for credit accounts, available credit)
      - `limit` number, nullable, required: Credit limit (for credit accounts only)
      - `interestRate` number, nullable, required: Interest rate as a decimal (e.g., 0.2499 for 24.99%)
    - `currency` string, nullable, required: Currency code (e.g., 'USD', 'EUR')
    - `mask` string, nullable, required: Last 4 digits or masked account number
    - `type` 'depository' | 'credit' | 'investment' | 'loan' | 'payment' | 'other', required: Account type (depository, credit, investment, loan, payment, other)
    - `subtype` string, nullable, required: Account subtype (checking, savings, credit card, mortgage, etc.)
    - `provider` 'Plaid' | 'GoCardless' | 'Stripe' | 'Mercury', required: The data provider for this account
    - `payment` PaymentInfo, required
      - `lastPaymentAmount` number, nullable, required: Amount of the last payment made
      - `lastPaymentDate` string, date, nullable, required: Date of the last payment (ISO 8601 date)
      - `nextPaymentDueDate` string, date, nullable, required: Next payment due date (ISO 8601 date)
      - `lastStatementBalance` number, nullable, required: Balance of the last statement
      - `minimumPaymentAmount` number, nullable, required: Minimum payment amount due
      - `nextMonthlyPayment` number, nullable, required: Next monthly payment amount (for loans/mortgages)
    - `loanOrigination` LoanOriginationInfo, required
      - `originationDate` string, date, nullable, required: Date the loan was originated (ISO 8601 date)
      - `originationPrincipalAmount` number, nullable, required: Original principal amount of the loan
  - `meta` object, required
    - `count` integer, required: Number of accounts in this response
    - `totalCount` integer, required: Total number of accounts available
    - `hasMore` boolean, required: Whether more results are available (always false, no pagination)

## Other responses

- `401`: Unauthorized - missing, invalid, disabled or expired API key
- `403`: API access requires active pro subscription or trial
- `429`: Rate limit exceeded - retry after the `retryAfter` timestamp
- `500`: Internal server error. Failures during authentication return MiddlewareErrorResponse; failures inside the endpoint return ErrorResponse.

---

[API](https://skmtc.dev/finta/apis/finta-api.md) · [All operations](https://skmtc.dev/finta/apis/finta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/finta/apis/finta-api/revisions/80b98582afde?raw)