---
title: "Get Account"
method: GET
path: "/digital-banking/v1/accounts/{account_id}"
tags: ["Accounts"]
---

# Get Account

`GET /digital-banking/v1/accounts/{account_id}`

## Request

- Base URL: `https://api.modernfi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.modernfi.com/digital-banking/v1/accounts/{account_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/modernfi/apis/endpoints/docs/digital-banking/v1/accounts/:account_id/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `account_id` union, required
  - string, uuid
  - string

## Query parameters

- `id_type` 'INSTITUTION': Type of the account id. Institution accounts ids are external ids and come from the institution.

## Response `200`

Successful Response

- AccountResponse
  - `id` string, required
  - `institution_id` string, required
  - `signer_primary` string, nullable, required
  - `signer_primary_tin_last4` string, nullable
  - `account_title` string, required
  - `interest_rate` string, required
  - `interest_rate_apy` string, required: Annual percentage yield of interest_rate under monthly compounding (decimal-as-string, 9 decimal places).
  - `mtd_accrued_interest` string, required: Interest accrued this calendar month (Eastern Time).
  - `interest_rate_tiers` InterestRateTierResponse[], required
    - `min_balance` string, required
    - `max_balance` string, required
    - `rate` string, nullable
    - `floating_spread` string, nullable
    - `rate_index_type` 'EFFR' | 'CU_RECEIVE_DEFAULT' | 'BANK_RECEIVE_DEFAULT' | 'EFFR_UPPER_BAND' | 'EFFR_LOWER_BAND' | 'SOFR_OVERNIGHT' | 'SOFR_1M' | 'SOFR_3M' | 'SOFR_6M' | 'SOFR_12M' | 'CMT_1M' | 'CMT_3M' | 'CMT_6M' | 'FIDELITY_FISXX' | 'FIDELITY_SPAXX' | 'FIDELITY_FCIXX' | 'WSJ_PRIME' | 'IORB'
    - `floating_rate_percentage` string, nullable
    - `custom_benchmark_id` string, nullable
  - `insurance_limit` string, required
  - `account_type` 'MMDA' | 'DDA', required
  - `created_at` string, required
  - `is_joint_account` boolean, required
  - `total_balance` string, required
  - `total_balance_updated_at` string, nullable: When total_balance last changed: the time the most recent transaction counted in it posted (ISO 8601). Null when no transaction has posted to the account.
  - `pending_balance` string, required
  - `closed_at` string, nullable
  - `signer_secondary` string, nullable
  - `beneficiary_name` string, nullable
  - `beneficiary_tin` string, nullable
  - `beneficiary_tin_last4` string, nullable
  - `institution_account_id` string, nullable
  - `institution_sweep_account_id` string, nullable
  - `institution_return_account_id` string, nullable
  - `institution_branch_id` string, nullable
  - `institution_alternative_id` string, nullable
  - `cost_center_id` string, nullable
  - `cost_center_code` string, nullable
  - `depositors` DepositorResponse[], nullable
    - `id` string, required
    - `institution_id` string, required
    - `institution_depositor_id` string, nullable, required
    - `tin` string, nullable
    - `tin_last_four` string, nullable: Last 4 digits of the TIN (masked).
    - `first_name` string, nullable, required
    - `last_name` string, nullable, required
    - `entity_name` string, nullable, required
    - `is_organization` boolean, required
    - `phone_numbers` PhoneNumberData[], required
      - `number` string, required
      - `is_primary` boolean
    - `emails` EmailData[], required
      - `email_address` string, email, required
      - `is_primary` boolean
    - `addresses` AddressData[], required
      - `street` string, required
      - `city` string, required
      - `state` string, required
      - `zip` string, required
      - `country_code` string, required: ISO 3166-1 alpha-2 country code (e.g., US)
      - `is_primary` boolean
    - `depositor_type` 'CONSUMER' | 'BUSINESS' | 'NONPROFIT' | 'LOCAL_GOVERNMENT' | 'FEDERAL_GOVERNMENT' | 'US_DEPOSITORY' | 'FOREIGN_DEPOSITORY' | 'FOREIGN_GOVERNMENT', required
    - `ownership_category` 'JOINT' | 'SINGLE' | 'RETIREMENT' | 'ESTATE_REVOCABLE_TRUST' | 'OTHER_CONSUMER' | 'CORPORATION' | 'LIMITED_LIABILITY_COMPANY' | 'LIMITED_PARTNERSHIP' | 'SOLE_PROPRIETORSHIP' | 'OTHER_BUSINESS' | 'CLUBS_ASSOCIATIONS' | 'OTHER_NONPROFIT' | 'MUNICIPALITIES' | 'SCHOOL_DISTRICTS' | 'OTHER_LOCAL_GOVERNMENT' | 'US_GOVERNMENT' | 'US_DEPOSITORY'
    - `account_officer` string, nullable
    - `notes` string, nullable
    - `institution_opt_out_federal_ids` string[]: List of institutions, identified by federal ID, excluded from receiving this depositor's funds.
  - `managed_sweep_target_balance` string, nullable
  - `shadow_account` ShadowAccountResponse
    - `id` string, required
    - `account_number` string, required
    - `account_type` 'MMDA' | 'DDA', required
    - `closed_at` string, nullable
  - `notes` string, nullable
  - `pricing_group_id` string, nullable
  - `is_reciprocation_prioritized` boolean, required
  - `is_receiving_printed_statements` boolean, required
  - `rate` string, nullable
  - `floating_spread` string, nullable
  - `floating_spread_bps` string, nullable
  - `rate_index_type` 'EFFR' | 'CU_RECEIVE_DEFAULT' | 'BANK_RECEIVE_DEFAULT' | 'EFFR_UPPER_BAND' | 'EFFR_LOWER_BAND' | 'SOFR_OVERNIGHT' | 'SOFR_1M' | 'SOFR_3M' | 'SOFR_6M' | 'SOFR_12M' | 'CMT_1M' | 'CMT_3M' | 'CMT_6M' | 'FIDELITY_FISXX' | 'FIDELITY_SPAXX' | 'FIDELITY_FCIXX' | 'WSJ_PRIME' | 'IORB'
  - `floating_rate_percentage` string, nullable
  - `index_rate` string, nullable
  - `custom_benchmark_id` string, nullable
  - `custom_benchmark_rate` string, nullable
  - `rate_configuration` 'FIXED' | 'FLOATING_MARKET' | 'FLOATING_CUSTOM' | 'TIERED' | 'MIXED', required
  - `account_officer` string, nullable: Account officer assigned to this account
  - `is_non_interest_bearing` boolean: Whether this account is non-interest-bearing
  - `custom_field_1` string, nullable: Custom field 1
  - `custom_field_2` string, nullable: Custom field 2
  - `custom_field_3` string, nullable: Custom field 3
  - `custom_field_4` string, nullable: Custom field 4
  - `is_q2_funds_transfer_enabled` boolean: Whether the Q2 digital banking integration may move this account's funds. False when the institution's Q2 enrollment is not enabled or the account is exempt from integration.

## Other responses

- `400`: Bad Request - Invalid input or validation error
- `401`: Unauthenticated - Invalid or missing authentication credentials
- `403`: Unauthorized - Insufficient permissions to access resource
- `422`: Validation Error
- `500`: Internal Server Error

## Changes

- **2026-10-30** `4bf4ac474dc0`: 2 info
  - added the required property `interest_rate_apy` to the response with the `200` status
  - added the required property `mtd_accrued_interest` to the response with the `200` status
- **2026-10-29** `f69326b5c460`: 1 info
  - added the optional property `total_balance_updated_at` to the response with the `200` status
- **2026-10-01** `af2d10c2af5d`: 1 info
  - added the optional property `is_q2_funds_transfer_enabled` to the response with the `200` status

[Operation history](https://skmtc.dev/modernfi/apis/endpoints/changes/digital-banking/v1/accounts/:account_id/get.md)

---

[API](https://skmtc.dev/modernfi/apis/endpoints.md) - [All operations](https://skmtc.dev/modernfi/apis/endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/modernfi/apis/endpoints/revisions/4bf4ac474dc0?raw)