---
title: "Get Depositor"
method: GET
path: "/digital-banking/v1/depositors/{depositor_id}"
tags: ["Depositors"]
---

# Get Depositor

`GET /digital-banking/v1/depositors/{depositor_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/depositors/{depositor_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/modernfi/apis/endpoints/docs/digital-banking/v1/depositors/:depositor_id/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `depositor_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

- DepositorResponse
  - `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.

## 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

---

[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)