curatedapi

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.

The amount financed: the credit the borrower receives, after any prepaid finance charges.
The payments in order. Give one amount per group of equal payments and the group sizes in payment_counts, e.g. ["210.71", "220.25"] with [24, 36]; without payment_counts each amount is one payment. 1 to 100 items. One per line, or separated by commas.
How many payments of each amount in payment_amounts (whole numbers, same order). Omit it when every amount is a single payment. Up to 100 items. One per line, or separated by commas.
How often payments are due; this is the unit-period. Options: monthly: 12 a year; semimonthly: 24 a year; biweekly: every 2 weeks, 26 a year; weekly: 52 a year; quarterly: 4 a year; semiannually: 2 a year; annually: once a year
When the loan is made (the finance charge starts). Give it with first_payment_date to count an odd first period; without both, the first payment is one full period after consummation.
When the first payment is due. Later payments follow at the payment frequency.
Payments are due on the last day of each month, so months are counted from month end to month end (Appendix J (b)(3)(iv)).
More options: rounding and decimals
Precision and rounding
Rounding mode applied once to each result. Default half_up.
Round results to this many digits after the decimal point.

Examples

Result: $5,000 in 24 monthly payments of $230, first payment 34 days after the loan

APR percent
The annual percentage rate, in percent. Unit: percent.
9.61 rounded
Finance charge
Total of payments minus the amount financed.
520.00 exact
Total of payments
Sum of all payments.
5,520.00 exact
Number of payments
Number of payments.
24
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.1
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).
yes
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.125

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 × 100

Computes 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

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

POST /v1/calc/finance/apr/us-reg-zVersion 1
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": "5000",
    "payment_amounts": ["230"],
    "payment_counts": ["24"],
    "consummation_date": "2026-01-12",
    "first_payment_date": "2026-02-15"
  }'
The same call in Python
import os

import requests

payload = {
    "amount_financed": "5000",
    "payment_amounts": ["230"],
    "payment_counts": ["24"],
    "consummation_date": "2026-01-12",
    "first_payment_date": "2026-02-15",
}
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": "5000",
    "payment_amounts": ["230"],
    "payment_counts": ["24"],
    "consummation_date": "2026-01-12",
    "first_payment_date": "2026-02-15",
};
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

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.