POST
/
borrowers
/
business
curl --request POST \
  --url https://production.pier-finance.com/api/borrowers/business \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
  "address": {
    "line_1": "15 Market St",
    "line_2": null,
    "city": "San Francisco",
    "state": "NJ",
    "zip": "94133"
  },
  "business_contact": {
    "first_name": "alex",
    "last_name": "montana",
    "phone": "4155555555",
    "email": "alex@acme.co",
    "title": "COO"
  },
  "beneficial_owners": [
    {
      "address": {
        "line_1": "15 Market St",
        "line_2": null,
        "city": "San Francisco",
        "state": "CA",
        "zip": "91133"
      },
      "date_of_birth": "1991-12-18",
      "email": "jdoe@acme.com",
      "first_name": "Jane",
      "last_name": "Dough",
      "percent_ownership": 2500,
      "phone": "4155555555",
      "ssn": "123456789",
      "id": "63ae91f8eae458cb0d79f77e"
    }
  ],
  "business_name": "Apple Landscaping",
  "business_type": "corporation",
  "dba_name": "Apple Landscaping",
  "ein": "130256721",
  "incorporation_date": "2000-12-12",
  "kyb_completion_date": "2022-11-15",
  "phone": "4152556465",
  "state_of_incorporation": "DE"
}'
{
  "address": {
    "line_1": "15 Market St",
    "line_2": null,
    "city": "San Francisco",
    "state": "NJ",
    "zip": "94133"
  },
  "business_contact": {
    "first_name": "alex",
    "last_name": "montana",
    "phone": "4155555555",
    "email": "alex@acme.co",
    "title": "COO"
  },
  "beneficial_owners": [
    {
      "address": {
        "line_1": "15 Market St",
        "line_2": null,
        "city": "San Francisco",
        "state": "CA",
        "zip": "91133"
      },
      "date_of_birth": "1991-12-18",
      "email": "jdoe@acme.com",
      "first_name": "Jane",
      "last_name": "Dough",
      "percent_ownership": 2500,
      "phone": "4155555555",
      "ssn": "123456789",
      "id": "63ae91f8eae458cb0d79f77e"
    }
  ],
  "id": "bor_18e5a3726b3943cda2635f40e1041ba4",
  "business_name": "Apple Landscaping",
  "business_type": "corporation",
  "dba_name": "Apple Landscaping",
  "ein": "130256721",
  "incorporation_date": "2000-12-12",
  "kyb_completion_date": "2022-11-15",
  "phone": "4152556465",
  "state_of_incorporation": "DE",
  "created_on": "2022-12-30T07:23:36.665Z"
}

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json
address
object
required

The address of the business.

beneficial_owners
object[]
required

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.

A person who owns owns 25% or more of the business as well as those who control the funds.

business_contact
object
required

The person executing the loan agreement.

business_name
string
required

Legal name of the business.

Example:

"Apple Landscaping"

business_type
enum<string>
required

The type of business entity.

Available options:
corporation,
llc,
partnership,
sole_proprietorship
dba_name
string
required

Doing-business-as name of the business

Example:

"Apple Landscaping"

ein
string
required

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

Example:

"130256721"

incorporation_date
string
required

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

Example:

"2000-12-12"

kyb_completion_date
string
required

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

Example:

"2022-11-15"

state_of_incorporation
string
required

Required 2-digit US state code (e.g. CA, IL, FL, …)

Example:

"DE"

phone
string
required

The phone number of the business

Example:

"4152556465"

Response

200
application/json
id
string
required
address
object
required
beneficial_owners
object[]
required

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.

A person who owns owns 25% or more of the business as well as those who control the funds.

business_contact
object
required

The person executing the loan agreement.

business_name
string
required

Legal name of the business

Example:

"Apple Landscaping"

business_type
enum<string>
required

The type of business entity.

Available options:
corporation,
llc,
partnership,
sole_proprietorship
created_on
string
required

Time stamp of borrower's creation date

Example:

"2022-12-30T07:23:36.665Z"

dba_name
string
required

Doing-business-as name of the business

Example:

"Apple Landscaping"

ein
string
required

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

Example:

"130256721"

incorporation_date
string
required

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

Example:

"2000-12-12"

kyb_completion_date
string
required

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

Example:

"2022-11-15"

phone
string
required

The phone number of the business

Example:

"4152556465"

state_of_incorporation
string
required

Required 2-digit US state code (e.g. CA, IL, FL, …)

Example:

"DE"