List Depositors | Modernfi

[
  {
    "id": "string",
    "institution_id": "string",
    "institution_depositor_id": "string",
    "first_name": "string",
    "last_name": "string",
    "entity_name": "string",
    "is_organization": true,
    "phone_numbers": [
      {
        "number": "string",
        "is_primary": true
      }
    ],
    "emails": [
      {
        "email_address": "string",
        "is_primary": true
      }
    ],
    "addresses": [
      {
        "street": "string",
        "city": "string",
        "state": "string",
        "zip": "string",
        "country_code": "string",
        "is_primary": true
      }
    ],
    "depositor_type": "CONSUMER",
    "tin_last_four": "string",
    "ownership_category": "JOINT",
    "account_officer": "string",
    "notes": "string",
    "institution_opt_out_federal_ids": [
      "string"
    ],
    "tin": "string"
  }
]

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

namestring or nullOptional

Search by first name, last name, or entity name (case-insensitive partial match).

institution_depositor_idstring or nullOptional

Filter by exact institution depositor ID.

depositor_typeenum or nullOptional

Filter by depositor type.

Response

Successful Response

idstring

institution_idstring

institution_depositor_idstring or null

first_namestring or null

last_namestring or null

entity_namestring or null

is_organizationboolean

phone_numberslist of objects

emailslist of objects

addresseslist of objects

depositor_typeenum

tin_last_fourstring or nullOptional

Last 4 digits of the TIN (masked).

ownership_categoryenum or nullOptional

account_officerstring or nullOptional

notesstring or nullOptional

institution_opt_out_federal_idslist of stringsOptional

List of institutions, identified by federal ID, excluded from receiving this depositor's funds.

tinstring or nullOptionalDeprecated

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error

500

Internal Server Error