Borrowers

Update a business borrower

PATCH
Updates an existing borrower. The full borrower object less a few unchangeable fields needs to be supplied in the update request.

Path parameters

borrower_idstringRequired

Request

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

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