---
title: "List all borrowers"
method: GET
path: "/borrowers"
tags: ["Borrowers"]
---

# List all borrowers

`GET /borrowers`

## Request

- Base URL: `https://production.pier-finance.com/api`
- URL: `https://production.pier-finance.com/api/borrowers`
- Auth: HTTP bearer

Retrieve all borrowers associated with your account

## Response `200`

- Borrower[]
  - union
    - object
      - `type` 'business', required
      - `id` string, required
      - `address` Address
        - `line_1` string, required: A string of 1-256 characters
        - `line_2` string, nullable: A string of 1-256 characters
        - `city` string, required: A string of 1-30 characters
        - `state` string, required: 2-digit US state code (e.g. CA, IL, FL)
        - `zip` string, required: 5-digit US zip code
      - `beneficial_owners` BeneficialOwners[], nullable: An array of objects representing owners of the business and those who control the funds of the business. If no one owns more than 25% of the business, just the individual who has ultimate control of the funds must be included. A maximum of 5 objects can be added.
        - `id` string, required
        - `address` Address, required
          - `line_1` string, required: A string of 1-256 characters
          - `line_2` string, nullable: A string of 1-256 characters
          - `city` string, required: A string of 1-30 characters
          - `state` string, required: 2-digit US state code (e.g. CA, IL, FL)
          - `zip` string, required: 5-digit US zip code
        - `date_of_birth` string, required: The person's date of birth (YYYY-MM-DD)
        - `email` string, required: The person's valid email address
        - `first_name` string, required: The person's first name
        - `last_name` string, required: The person's last name
        - `phone` string, required: The person's 10-digit US phone number (e.g. 4152251000)
        - `percent_ownership` integer, required: The percent ownership the person has in the business in basis points (e.g. 2500 for 25%)
      - `business_contact` BusinessContact
        - `first_name` string, required: The person's first name
        - `last_name` string, required: The person's last name
        - `phone` string, required: The person's 10-digit US phone number (e.g. 4152251000)
        - `email` string, required: The person's valid email address
        - `title` string, required: The person's title in the company (e.g. COO)
      - `business_name` string, required: Legal name of the business
      - `business_type` 'corporation' | 'llc' | 'partnership' | 'sole_proprietorship', required
      - `created_on` string, nullable: Time stamp of borrower's creation date
      - `dba_name` string, nullable: Doing-business-as name of the business
      - `ein` string, nullable: 9-digit IRS employee identification number of the business (e.g. 345543221)
      - `incorporation_date` string, nullable: Incorporation date of the business (YYYY-MM-DD)
      - `kyb_completion_date` string, nullable: Date kyb completed on the business (YYYY-MM-DD)
      - `phone` string, nullable: The phone number of the business
      - `state_of_incorporation` string, required: Required 2-digit US state code (e.g. CA, IL, FL, …)
    - object
      - `type` 'consumer', required
      - `address` Address, required
        - `line_1` string, required: A string of 1-256 characters
        - `line_2` string, nullable: A string of 1-256 characters
        - `city` string, required: A string of 1-30 characters
        - `state` string, required: 2-digit US state code (e.g. CA, IL, FL)
        - `zip` string, required: 5-digit US zip code
      - `date_of_birth` string, required: The borrower's date of birth (YYYY-MM-DD)
      - `id` string, required
      - `email` string, required: The borrower's valid email address
      - `first_name` string, required: The borrower's first name (min. 2 characters)
      - `last_name` string, required: The borrower's last name (min. 2 characters)
      - `kyc_completion_date` string, required: Date kyc completed on the borrower (YYYY-MM-DD)
      - `government_identifiers` GovernmentIdentifiers, required
        - `ssn` string, nullable: The borrower's 9-digit social security number (e.g. 345543221)
        - `ssn_last_4` string, nullable: The last 4 digits of the borrower's social security number
        - `itin` string, nullable: The borrower's 9-digit individual taxpayer identification number (e.g. 345543221)
        - `passport` Passport
          - `country` string, required: ISO 3166-1 Alpha-3 code representing the country of issue (e.g. USA)
          - `number` string, required: The passport number
          - `expiration_date` string, nullable: The expiration date of the passport (YYYY-MM-DD)
          - `issue_date` string, required: The issue date of the passport (YYYY-MM-DD)
        - `drivers_license` DriversLicense
          - `country` string, required: ISO 3166-1 Alpha-3 code representing the country of issue (e.g. USA)
          - `province` string, required: Adapted ISO 3166-2 code with Alpha-3 country code prefix (e.g. USA-CA)
          - `number` string, required: The passport number
          - `expiration_date` string, nullable: The expiration date of the passport (YYYY-MM-DD)
          - `issue_date` string, required: The issue date of the passport (YYYY-MM-DD)
      - `created_on` string, date-time, required: The date the borrower was created

## Other responses

- `401`
- `429`
- `500`

---

[API](https://skmtc.dev/pier-finance/apis/pier-api.md) - [All operations](https://skmtc.dev/pier-finance/apis/pier-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pier-finance/apis/pier-api/revisions/08a7c49252b9?raw)