Request Sandbox KeysSee a Demo
  • Overview
    • Quickstart
    • Payments and Disbursements
    • Errors
    • Webhooks
  • Guides
    • Compliance
    • Starter Mode
    • KYC
    • Line of Credit program
    • Buy Now Pay Later program
  • API Reference
LogoLogo
Request Sandbox KeysSee a Demo
API ReferenceFacilities

Update credit limit for a line of credit

PATCH
/facilities/:facility_id/update_limit
PATCH
/api/facilities/:facility_id/update_limit
1curl -X PATCH https://production.pier-finance.com/api/facilities/fac_18e5a3726b3943cda2635f40e1041ba4/update_limit \
2     -H "Authorization: Bearer <token>" \
3     -H "Content-Type: application/json" \
4     -d '{
5  "new_limit_amount": 100000
6}'
Try it
200Updated
1{
2  "id": "fac_18e5a3726b3943cda2635f40e1041ba4",
3  "application_id": "app_f0467657bba948e6a87292e182132848",
4  "borrower_id": "bor_a1d0c30d77104f35b4c842b99132624e",
5  "loan_agreement_id": "doc_43da3b3f95c745e1985a71e9a00d6c27",
6  "credit_type": "consumer_installment_loan",
7  "created_on": "2023-05-12T19:46:09.293Z",
8  "status": "active",
9  "account_number": "401542198",
10  "transactions": [
11    {
12      "amount": 100000,
13      "net_amount": 100000,
14      "transaction_date": "2023-05-12",
15      "effective_date": "2023-05-12",
16      "description": "Disbursement",
17      "category": "DISBURSEMENT",
18      "transaction_type": "DEBIT",
19      "transaction_iso_timestamp": "2023-05-12T00:00:00.000Z"
20    },
21    {
22      "amount": 500000,
23      "net_amount": -500000,
24      "transaction_date": "2024-06-02",
25      "effective_date": "2024-06-02",
26      "description": "Principal Reduction",
27      "category": "PRINCIPAL_REDUCTION",
28      "transaction_type": "CREDIT",
29      "transaction_iso_timestamp": "2023-05-12T00:00:00.000Z"
30    }
31  ],
32  "statements": [
33    {
34      "id": "stmt_deb6aba913d84feb987934f50c32bf03",
35      "statement_date": "2023-03-17",
36      "statement_start_date": "2024-06-17T00:00:00.000Z",
37      "balance_due": 500000,
38      "current_principal_balance": 500000,
39      "current_interest_balance": 10000,
40      "interest_charged": 0,
41      "due_date": "2023-03-17",
42      "transactions": [
43        {
44          "amount": 100000,
45          "net_amount": 100000,
46          "transaction_date": "2023-05-12",
47          "effective_date": "2023-05-12",
48          "description": "Disbursement",
49          "category": "DISBURSEMENT",
50          "transaction_type": "DEBIT",
51          "transaction_iso_timestamp": "2023-05-12T00:00:00.000Z"
52        },
53        {
54          "amount": 500000,
55          "net_amount": -500000,
56          "transaction_date": "2024-06-02",
57          "effective_date": "2024-06-02",
58          "description": "Principal Reduction",
59          "category": "PRINCIPAL_REDUCTION",
60          "transaction_type": "CREDIT",
61          "transaction_iso_timestamp": "2023-05-12T00:00:00.000Z"
62        }
63      ],
64      "payments": [
65        {
66          "id": "pmt_18e5a3726b3943cda2635f40e1041ba4",
67          "amount": 100000,
68          "facility_id": "fac_18e5a3726b3943cda2635f40e1041ba4",
69          "status": "settled",
70          "transfer_type": "standard",
71          "created_on": "2023-02-27T00:00:00Z",
72          "is_autopay": false
73        }
74      ],
75      "disbursements": [
76        {
77          "id": "dsb_18e5a3726b3943cda2635f40e1041ba4",
78          "facility_id": "fac_18e5a3726b3943cda2635f40e1041ba4",
79          "amount": 100000,
80          "status": "pending",
81          "created_on": "2023-02-27T00:00:00Z",
82          "transfer_type": "standard",
83          "failure_reason": null,
84          "date": "2023-02-27"
85        }
86      ],
87      "facility_id": "fac_18e5a3726b3943cda2635f40e1041ba4",
88      "url": "https://app.docspring.com/submissions/sub_gjX2LS7c6FjqZt12hQ/download",
89      "created_on": "2023-02-27T00:00:00Z"
90    }
91  ],
92  "balances": {
93    "current_balance": 500000,
94    "principal_balance": 500000,
95    "interest_balance": 0,
96    "payoff_balance": 500000
97  },
98  "payments_due": [
99    {
100      "payment_amount": 123456,
101      "payment_amount_remaining": 123456,
102      "payment_due_date": "2023-06-12"
103    }
104  ],
105  "terms": {
106    "type": "loan_offer",
107    "amount": 1000000,
108    "id": "off_86c05092a4384d89b03ef514ea4fee31",
109    "loan_term": {
110      "term_type": "months",
111      "term": 36
112    },
113    "first_payment_date": "2022-12-31",
114    "grace_period": {
115      "term": 0,
116      "interest_rate": 0
117    },
118    "interest_rate": 0,
119    "introductory_promo_period": {
120      "interest_rate": 0,
121      "promo_term": {
122        "term": 90,
123        "term_type": "daily"
124      }
125    },
126    "late_payment_fee": 0,
127    "origination_fee": {
128      "type": "deducted",
129      "fee": 0
130    },
131    "payment_period": "monthly"
132  },
133  "remaining_statement_balance": 7500,
134  "remaining_minimum_balance": 7500,
135  "amortization_schedule": [
136    {
137      "payment_date": "2023-11-02",
138      "interest_payment_amount": 0,
139      "principal_payment_amount": 8333,
140      "other_payment_amount": 0,
141      "total_payment_amount": 8333,
142      "balance_amount": 91667,
143      "item_index": 1
144    },
145    {
146      "payment_date": "2023-12-02",
147      "interest_payment_amount": 0,
148      "principal_payment_amount": 8333,
149      "other_payment_amount": 0,
150      "total_payment_amount": 8333,
151      "balance_amount": 83334,
152      "item_index": 2
153    }
154  ],
155  "repayment_bank_details": {
156    "bank_account_number": "98989898",
157    "bank_routing_number": "021000021",
158    "type": "checking"
159  },
160  "balance": 500000,
161  "origination_date": "2023-05-12",
162  "disbursement_date": "2023-05-12",
163  "remaining_term": 48,
164  "next_payment_amount": 124425,
165  "next_payment_due_date": "2023-06-12",
166  "current_payment_due_date": "2023-06-12",
167  "last_payment_date": null,
168  "principal_paid_thru": "2023-05-11",
169  "next_billing_date": "2023-05-28",
170  "interest_accrued_thru": "2023-05-11",
171  "next_accrual_cutoff_date": "2023-06-11",
172  "scheduled_payoff_date": "2027-05-12",
173  "autopay": {
174    "authorized": false
175  },
176  "documents": {
177    "unsigned_credit_agreement": {
178      "document_url": "https://storage.googleapis.com/example/unsigned_credit_agreement.pdf",
179      "document_id": "doc_1234567890abcdef"
180    },
181    "signed_credit_agreement": {
182      "document_url": "https://storage.googleapis.com/example/signed_credit_agreement.pdf",
183      "document_id": "doc_abcdef1234567890"
184    },
185    "unsigned_ach_authorization": {
186      "document_url": "https://storage.googleapis.com/example/unsigned_ach_authorization.pdf",
187      "document_id": "doc_fedcba9876543210"
188    },
189    "unsigned_autopay_ach_authorization": {
190      "document_url": "https://storage.googleapis.com/example/unsigned_autopay_ach_authorization.pdf",
191      "document_id": "doc_0123456789abcdef"
192    },
193    "signed_ach_authorization": {
194      "document_url": "https://storage.googleapis.com/example/signed_ach_authorization.pdf",
195      "document_id": "doc_fedcba0987654321"
196    },
197    "signed_autopay_ach_authorization": {
198      "document_url": "https://storage.googleapis.com/example/signed_autopay_ach_authorization.pdf",
199      "document_id": "doc_0123456789abcdef"
200    }
201  },
202  "last_statement_info": {
203    "last_statement_date": "2024-06-01T00:00:00.000Z",
204    "last_statement_amount": 47000
205  },
206  "in_grace_period": false,
207  "in_introductory_promo_period": false,
208  "interest_balance": 0,
209  "payoff_balance": 500000
210}
Update credit limit for a line of credit. For reductions, pass in the document_id from the create_limit_reduction_notice endpoint. For increases, pass in the new credit limit amount.
Was this page helpful?
Previous

List all payments for a facility

Next
Built with
List all payments for a facility

Authentication

AuthorizationBearer
Bearer authentication of the form `Bearer <token>`, where token is your auth token.

Path parameters

facility_idstringRequired

Request

This endpoint expects an object.
new_limit_amountintegerOptional
The new credit limit amount, in cents
document_idstringOptional
The document_id from the `create_limit_reduction_notice` endpoint

Response

This endpoint returns an object.
idstring
application_idstring

The application_id of the corresponding loan application for the facility

borrower_idstring
The `borrower_id` of the corresponding borrower the facility is for
loan_agreement_idstring

The loan_agreement_id of the corresponding loan agreement the facility is for

credit_typeenum
The type of credit production.
created_ondatetime
Timestamp the loan agreement object is created on
statusenum
The status of the facility.
Allowed values:
account_numberstring
The account number of the credit facility
transactionslist of objects
An array of transactions made (empty if no payments are due)
statementslist of objects
An array of statements for the loan (empty if no statements exist)
balancesobject
A deeper view of what makes up the facility balance, all in cents
payments_duelist of objects
An array of payments due (empty if no payments are due)
termsobject
An object containing a summary of the terms of the facility.
remaining_statement_balanceinteger
The amount, in cents, of the last statement balance, less any payments made after the statement was created. Will be set to null until first statement is created.
remaining_minimum_balanceinteger
The minimum due, in cents, of the last statement minimum, less any payments made since the statement was created. Will be set to null until first statement is created.
amortization_schedulelist of objects or null
The amortization schedule of the loan
repayment_bank_detailsobject or null
The bank account information used to repay the loan
balanceinteger or null
The remaining balance of the loan, in cents
origination_datestring or null
The date the loan was originated (YYYY-MM-DD)
disbursement_datestring or null
The date the loan was disbursed (YYYY-MM-DD)
remaining_terminteger or null
The remaining term of the loan, in months
next_payment_amountinteger or null
The amount of the next payment, in cents
next_payment_due_datestring or null
The date the next payment is due (YYYY-MM-DD)
current_payment_due_datestring or null
The date the current payment is due (YYYY-MM-DD)
last_payment_datestring or null
The date the last payment was made (YYYY-MM-DD)
principal_paid_thrustring or null
The date the principal is paid through (YYYY-MM-DD)
next_billing_datestring or null
The next billing date of the loan (YYYY-MM-DD)
interest_accrued_thrustring or null
The date the interest is accrued through (YYYY-MM-DD)
next_accrual_cutoff_datestring or null
The next accrual cutoff date of the loan (YYYY-MM-DD)
scheduled_payoff_datestring or null
The scheduled payoff date of the loan (YYYY-MM-DD)
autopayobject or null
Whether or not autopay is enabled for the facility.
documentsobject or null
The documents associated with the facility
last_statement_infoobject or null
The last statement information including date/amount.
in_grace_periodboolean or null
Whether the facility is in a grace period
in_introductory_promo_periodboolean or null
Whether the facility is in an introductory promotional period
interest_balanceinteger or nullDeprecated
The current interest balance of the loan, in cents (deprecated - see balances field)
payoff_balanceinteger or nullDeprecated
The current payoff balance of the loan, in cents (deprecated - see balances field)

Errors

An array of transactions made (empty if no payments are due)

An array of statements for the loan (empty if no statements exist)

An array of payments due (empty if no payments are due)

The date the loan was originated (YYYY-MM-DD)

The date the loan was disbursed (YYYY-MM-DD)

The date the next payment is due (YYYY-MM-DD)

The date the current payment is due (YYYY-MM-DD)

The date the last payment was made (YYYY-MM-DD)

The date the principal is paid through (YYYY-MM-DD)

The next billing date of the loan (YYYY-MM-DD)

The date the interest is accrued through (YYYY-MM-DD)

The scheduled payoff date of the loan (YYYY-MM-DD)

The next accrual cutoff date of the loan (YYYY-MM-DD)

The current interest balance of the loan, in cents (deprecated - see balances field)

The last statement information including date/amount.

The current payoff balance of the loan, in cents (deprecated - see balances field)

Bearer authentication of the form Bearer <token>, where token is your auth token.

Update credit limit for a line of credit. For reductions, pass in the document_id from the create_limit_reduction_notice endpoint. For increases, pass in the new credit limit amount.

The borrower_id of the corresponding borrower the facility is for

The document_id from the create_limit_reduction_notice endpoint