curatedapi

EU and UK APRC calculator

Annual percentage rate of charge (APRC, the UK's APR) for consumer and mortgage credit, by the EU directives' equation and day count.

The credit, drawn down in full at the start.
Charges the consumer pays at the start (arrangement or valuation fees, for example). Charges paid later go into the payments they are paid with.
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 made. Options: monthly: every month, 1/12 of a year; quarterly: every 3 months; semiannually: every 6 months; annually: every year; weekly: every week, 1/52 of a year; fortnightly: every 2 weeks
Date of the drawdown (the credit agreement). Give it with first_payment_date to count exact days; without both, the first payment is one period after the drawdown.
Date of the first payment. Later payments fall on the same day of the month (or the same weekday) at the payment frequency.
Also return each payment with its time in years.
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: The same loan signed 12 January 2012, paid on the 15th from February 2012

APRC percent
The annual percentage rate of charge, in percent, rounded half up. Unit: percent.
6.434185 rounded
Total amount payable
Upfront charges plus all payments.
348,056.800000 exact
Total cost of credit
Total amount payable minus the credit amount.
148,056.800000 exact
Number of payments
Number of payments.
240

Rounding: Half up, 6 decimal places. Calculator finance/apr/eu-aprc@1.

How it is calculated

credit − upfront charges = Σ P_j (1 + X)^(−t_j), t_j in years; APRC = X × 100

Computes the annual percentage rate of charge defined in the EU Consumer Credit and Mortgage Credit Directives (Annex III and Annex I) and in the UK FCA rules (CONC App 1, MCOB 10A): the yearly rate X at which the payments, discounted with (1 + X) to the power of minus their time in years, equal the credit drawn down less the charges paid at the start. Times are 1/12 of a year per month and 1/52 per week; with dates, whole months (or weeks, or years) are counted back from each payment and the remaining days divided by 365 or 366, as the Mortgage Credit Directive and the European Commission's guidelines prescribe. The equation is solved with proven bounds and the APRC is rounded half up, to 1 decimal by default.

  • The credit is drawn down in full at the start (assumption (a) of the directives' Annex I, Part II) and repaid by the payments given; credit with several drawdowns is not covered yet.
  • Include every cost in the total cost of credit: insurance premiums or account fees paid with the instalments go into the payments, a closing fee into the last payment.
  • With dates, each interval is whole months (whole weeks for weekly payments, whole years for yearly ones) counted back from the payment date, plus the remaining days divided by the 365 or 366 days of the year counted back from the last of those days: the Mortgage Credit Directive's rule, which MCOB 10A repeats and the Commission recommends for consumer credit too.
  • The directives require at least one decimal place, rounded half up; set options.decimals for more.

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/eu-aprcVersion 1
curl https://api.curatedapi.com/v1/calc/finance/apr/eu-aprc \
  -H "Authorization: Bearer $CURATEDAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "credit_amount": "200000",
    "upfront_charges": "4000",
    "payment_amounts": ["1433.57"],
    "payment_counts": ["240"],
    "start_date": "2012-01-12",
    "first_payment_date": "2012-02-15",
    "options": {"decimals": 6}
  }'
The same call in Python
import os

import requests

payload = {
    "credit_amount": "200000",
    "upfront_charges": "4000",
    "payment_amounts": ["1433.57"],
    "payment_counts": ["240"],
    "start_date": "2012-01-12",
    "first_payment_date": "2012-02-15",
    "options": {
        "decimals": 6,
    },
}
response = requests.post(
    "https://api.curatedapi.com/v1/calc/finance/apr/eu-aprc",
    headers={"Authorization": f"Bearer {os.environ['CURATEDAPI_KEY']}"},
    json=payload,
    timeout=10,
)
print(response.json()["result"])
The same call in JavaScript
const payload = {
    "credit_amount": "200000",
    "upfront_charges": "4000",
    "payment_amounts": ["1433.57"],
    "payment_counts": ["240"],
    "start_date": "2012-01-12",
    "first_payment_date": "2012-02-15",
    "options": {
        "decimals": 6,
    },
};
const response = await fetch("https://api.curatedapi.com/v1/calc/finance/apr/eu-aprc", {
  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_eu_aprc at https://mcp.curatedapi.com. Inputs, outputs and errors in the API reference.

Put it on your website

<div data-curatedapi-widget="finance/apr/eu-aprc" 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.