Borrowers

Create a business borrower

POST
Creates a business borrower. Business borrowers must have a unique EIN.

Request

This endpoint expects an object.
business_name
stringRequired
Legal name of the business.
business_type
enumRequired
The type of business entity.
Allowed values: corporationllcpartnershipsole_proprietorship
state_of_incorporation
stringRequired
Required 2-digit US state code (e.g. CA, IL, FL, …)
address
objectOptional
The address of the business.
beneficial_owners
list of objectsOptional
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.
business_contact
objectOptional
The person executing the loan agreement.
dba_name
stringOptional
Doing-business-as name of the business
ein
stringOptional
9-digit IRS employee identification number of the business (e.g. 345543221)
incorporation_date
stringOptional
Incorporation date of the business (YYYY-MM-DD)
kyb_completion_date
stringOptional
Date kyb completed on the business (YYYY-MM-DD)
phone
stringOptional
The phone number of the business

Response

This endpoint returns an object
id
string
address
object
beneficial_owners
list of objects
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.
business_contact
object
The person executing the loan agreement.
business_name
string
Legal name of the business
business_type
enum
The type of business entity.
Allowed values: corporationllcpartnershipsole_proprietorship
created_on
string
Time stamp of borrower's creation date
dba_name
string
Doing-business-as name of the business
incorporation_date
string
Incorporation date of the business (YYYY-MM-DD)
kyb_completion_date
string
Date kyb completed on the business (YYYY-MM-DD)
phone
string
The phone number of the business
state_of_incorporation
string
Required 2-digit US state code (e.g. CA, IL, FL, …)

Errors

POST
1curl -X POST https://production.pier-finance.com/api/borrowers/business \
2 -H "Authorization: Bearer <token>" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "business_name": "Apple Landscaping",
6 "business_type": "corporation",
7 "state_of_incorporation": "DE",
8 "address": {
9 "line_1": "15 Market St",
10 "city": "San Francisco",
11 "state": "NJ",
12 "zip": "94133",
13 "line_2": null
14 },
15 "beneficial_owners": [
16 {
17 "address": {
18 "line_1": "15 Market St",
19 "city": "San Francisco",
20 "state": "CA",
21 "zip": "91133",
22 "line_2": null
23 },
24 "date_of_birth": "1991-12-18",
25 "email": "jdoe@acme.com",
26 "first_name": "Jane",
27 "government_identifiers": {
28 "ssn": "123456789"
29 },
30 "id": "63ae91f8eae458cb0d79f77e",
31 "last_name": "Dough",
32 "percent_ownership": 2500,
33 "phone": "4155555555"
34 }
35 ],
36 "business_contact": {
37 "first_name": "alex",
38 "last_name": "montana",
39 "phone": "4155555555",
40 "email": "alex@acme.co",
41 "title": "COO"
42 },
43 "dba_name": "Apple Landscaping",
44 "ein": "130256721",
45 "incorporation_date": "2000-12-12",
46 "kyb_completion_date": "2022-11-15",
47 "phone": "4152556465"
48}'
1{
2 "id": "bor_18e5a3726b3943cda2635f40e1041ba4",
3 "address": {
4 "line_1": "15 Market St",
5 "city": "San Francisco",
6 "state": "NJ",
7 "zip": "94133",
8 "line_2": null
9 },
10 "beneficial_owners": [
11 {
12 "id": "63ae91f8eae458cb0d79f77e",
13 "address": {
14 "line_1": "15 Market St",
15 "city": "San Francisco",
16 "state": "CA",
17 "zip": "91133",
18 "line_2": null
19 },
20 "date_of_birth": "1991-12-18",
21 "email": "jdoe@acme.com",
22 "first_name": "Jane",
23 "last_name": "Dough",
24 "phone": "4155555555",
25 "percent_ownership": 2500
26 }
27 ],
28 "business_contact": {
29 "first_name": "alex",
30 "last_name": "montana",
31 "phone": "4155555555",
32 "email": "alex@acme.co",
33 "title": "COO"
34 },
35 "business_name": "Apple Landscaping",
36 "business_type": "corporation",
37 "created_on": "2022-12-30T07:23:36.665Z",
38 "dba_name": "Apple Landscaping",
39 "incorporation_date": "2000-12-12",
40 "kyb_completion_date": "2022-11-15",
41 "phone": "4152556465",
42 "state_of_incorporation": "DE"
43}