US APR calculator (Truth in Lending, Regulation Z)
The annual percentage rate of a closed-end loan the way Regulation Z Appendix J defines it (actuarial method), with odd first periods and the accuracy tolerance.
- Version 1
- Checked against 4 published values
- Free, no sign-up
Result: Regulation Z step-rate example: $10,000, 24 × $210.71, 24 × $220.25, 12 × $222.59
| APR percent The annual percentage rate, in percent. Unit: percent. |
10.75 rounded |
|---|---|
| Finance charge Total of payments minus the amount financed. |
3,014.12 exact |
| Total of payments Sum of all payments. |
13,014.12 exact |
| Number of payments Number of payments. |
60 |
| Unit period The unit-period used. |
month |
| Unit periods per year Unit-periods in a year; APR = rate per unit-period × this (exact). |
12 |
| First payment unit periods Full unit-periods from consummation to the first payment. |
1 |
| First period fraction The odd fraction of a unit-period before the first payment (0 for none). |
0 |
| Regular transaction True when the payments are equal (apart from the first and the last), so the 1/8 point tolerance applies; false for irregular payments (1/4 point). |
no |
| Tolerance percent A disclosed APR within this many percentage points of the exact APR is accurate (Regulation Z § 1026.22(a)(2) and (3)). |
0.25 |
Rounding: Half up, 2 decimal places. Calculator finance/apr/us-reg-z@1.
How it is calculated
A = Σ P_j / ((1 + f·i)(1 + i)^t_j); APR = i × unit-periods per year × 100Computes the APR that US lenders must disclose under the Truth in Lending Act, using the actuarial method of Regulation Z, Appendix J: the rate per unit-period at which the payments, discounted back to consummation, equal the amount financed, times the number of unit-periods in a year. An odd first period is counted the way Appendix J counts it: full months back from the first payment date and the remaining days divided by 30, with simple interest for the fraction. Single-payment loans use the term as the unit-period. The equation is solved exactly and the APR is correctly rounded; the response also gives the finance charge and whether the 1/8 or 1/4 percentage point tolerance applies.
- One advance at consummation and payments at regular intervals, with an odd first period allowed; loans with several advances or irregular intervals are not covered yet.
- All months count as equal (Appendix J (b)(3)(iv)): an odd first period is the days counted forward from consummation to one full month before the first payment, divided by 30. When a month lacks the payment day, its last day is used.
- A single payment is a single advance, single payment transaction: its term is the unit-period ((b)(5)(vi) and (vii)). Without dates a weekly or biweekly payment is a term of 7 or 14 days, so 365 ÷ 7 or 365 ÷ 14 unit-periods a year; a semimonthly single payment needs dates.
- The APR is the exact solution of the Appendix J equation, rounded half up to 2 decimals by default; set options.decimals for more.
- Fees paid before or at consummation that are finance charges belong in the finance charge: subtract them from the loan amount to get the amount financed.
References
- Regulation Z, Appendix J: Annual percentage rate computations for closed-end credit transactions
- Regulation Z, official interpretation of § 1026.22 (step-rate and add-on rate examples, tolerances)
Results follow each calculator's documented rules and the sources listed. They are not financial, tax or legal advice. Check that the rules fit your case before you rely on a result. See the terms.
Use it from your code
curl https://api.curatedapi.com/v1/calc/finance/apr/us-reg-z \
-H "Authorization: Bearer $CURATEDAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"amount_financed": "10000",
"payment_amounts": ["210.71", "220.25", "222.59"],
"payment_counts": ["24", "24", "12"]
}'
The same call in Python
import os
import requests
payload = {
"amount_financed": "10000",
"payment_amounts": ["210.71", "220.25", "222.59"],
"payment_counts": ["24", "24", "12"],
}
response = requests.post(
"https://api.curatedapi.com/v1/calc/finance/apr/us-reg-z",
headers={"Authorization": f"Bearer {os.environ['CURATEDAPI_KEY']}"},
json=payload,
timeout=10,
)
print(response.json()["result"])
The same call in JavaScript
const payload = {
"amount_financed": "10000",
"payment_amounts": ["210.71", "220.25", "222.59"],
"payment_counts": ["24", "24", "12"],
};
const response = await fetch("https://api.curatedapi.com/v1/calc/finance/apr/us-reg-z", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CURATEDAPI_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify(payload),
});
console.log((await response.json()).result);
MCP tool calc_finance_apr_us_reg_z at https://mcp.curatedapi.com.
Inputs, outputs and errors in the API reference.
Put it on your website
<div data-curatedapi-widget="finance/apr/us-reg-z" data-key="capi_public_…"></div>
<script src="https://widgets.curatedapi.com/v1/widget.js" async></script>
Use a public key registered for your site. Calculations are billed like API calls. How widgets work.
Related calculators
- Black-76 calculator for options on futures
- Black-Scholes option price and Greeks calculator
- Bond duration and convexity calculator
- Compound interest calculator
- EU and UK APRC calculator
- Extra mortgage payment calculator
- FHA mortgage insurance (MIP) calculator
- Implied volatility calculator
- Internal rate of return (IRR) calculator
- Loan EMI calculator
- Mortgage affordability calculator
- Mortgage calculator
- Net present value (NPV) calculator
- Refinance break-even calculator
- Rent or buy calculator
- Return on investment (ROI) calculator
- Savings goal calculator
- Simple interest calculator
- USDA loan guarantee fee calculator
- VA funding fee calculator
- Yield to call calculator
Quote an APR worked out by the regulation's method
For lenders, brokers, dealers and comparison sites. Each answer carries the inputs it used and the calculator version, ready for an audit file.
Free for up to 1,000 loan quotes a month. 50,000 loan quotes a month cost $9.00 on the Starter plan.