Borrowers

Borrowers represent a legal borrower, and can either be a consumer (e.g. for personal loans and lines of credit) or a business (e.g. for commercial charge cards and loans). Creating a borrower (or referencing an existing one) is the first step in the Pier credit origination process.

Create a business borrower

POST /borrowers/business

Update business borrower

PATCH /borrowers/business/{borrower_id}

Create a consumer borrower

POST /borrowers/consumer

Update a consumer borrower

PATCH /borrowers/consumer/{borrower_id}

Retrieve a borrower by id

GET /borrowers/{borrower_id}

List all borrowers

GET /borrowers

Business Borrower

Attributes

id · string

Unique identifier for the object

address · object

The address of the business. See Address type

beneficial_owners · array of BeneficialOwners

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. See BeneficialOwner type

business_contact · object

The person executing the loan agreement. See BusinessContact type

business_name · string

Legal name of the business

business_type · enum

The type of business entity. Accepted values are corporation, llc, partnership, or sole_proprietorship

created_on · string

Time stamp of borrower’s creation date

dba_name · string

Doing-business-as name of the business

ein · string

9-digit IRS employee identification number of the business (e.g. 345543221)

incorporation_date · string

Incorporation date of the business (YYYY-MM-DD)

incorporation_date · string

Incorporation date of the business (YYYY-MM-DD)

kyb_completed_date · string

Date kyb completed on the business (YYYY-MM-DD)

The business borrower object

Example Business Borrower object

{
  "address": {
    "line_1": "15 Market St",
    "line_2": "Suite 200",
    "city": "San Francisco",
    "state": "CA",
    "zip": "94133"
  },
  "business_contact": {
    "first_name": "alex",
    "last_name": "montana",
    "phone": "4155555555",
    "email": "[e-mail]",
    "title": "COO"
  },
  "beneficial_owners": [
    {
      "address": {
        "line_1": "15 Carl St",
        "line_2": null,
        "city": "San Francisco",
        "state": "CA",
        "zip": "91133"
      },
      "date_of_birth": "1991-12-18",
      "email": "[e-mail]",
      "first_name": "Jane",
      "last_name": "Dough",
      "phone": "4155555555",
      "ssn": "123456789",
      "_id": "63ae91f8eae458cb0d79f77e"
    }
  ],
  "id": "bor_18e5a3726b3943cda2635f40e1041ba4",
  "business_name": "Apple Landscaping",
  "business_type": "sole_proprietorship",
  "dba_name": "Apple Landscaping",
  "ein": "130256721",
  "incorporation_date": "2000-12-12",
  "kyc_completion_date": "2022-11-15",
  "phone": "4152556465",
  "created_on": "2022-12-30T07:23:36.665Z"
}

Consumer borrower object

Attributes

id · string

Unique identifier for the object

address · object

The address of the borrower. See Address type

created_on · string

Time stamp of borrower’s creation date

date_of_birth · string

The borrower’s date of birth (YYYY-MM-DD)

email · string

The borrower’s valid email address

first_name · string

The borrower’s first name

last_name · string

The borrower’s last name

kyc_completed_date · string

Date kyc completed on the borrower (YYYY-MM-DD)

phone · string

The borrower’s 10-digit US phone number (e.g. 4152775050)

ssn · string

9-digit social security number of the borrower (e.g. 345543221)

Consumer borrower object

Example Consumer Borrower object

{
  "address": {
    "line_1": "15 Main Street",
		"line_2": "Unit 204",
    "city": "Austin",
    "state": "TX",
    "zip": "73301"
  },
  "id": "bor_a1d0c30d77104f35b4c842b99132624e",
  "date_of_birth": "1991-12-18",
  "email": "[e-mail]",
  "first_name": "Jane",
  "last_name": "Dough",
  "ssn": "999888777",
  "kyc_completion_date": "2022-11-15",
  "created_on": "2022-12-31T00:58:47.828Z"
}