EU and UK APRC API
Annual percentage rate of charge (APRC, the UK's APR) for consumer and mortgage credit, by the EU directives' equation and day count.
POST https://api.curatedapi.com/v1/calc/finance/apr/eu-aprc
- Version 1
- MCP tool
calc_finance_apr_eu_aprc - Try it in the browser
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.
Formula
credit − upfront charges = Σ P_j (1 + X)^(−t_j), t_j in years; APRC = X × 100
- 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.
Inputs
Send numbers as strings to keep every digit. options sets precision and rounding (see numbers and rounding).
| Input | Type | Description |
|---|---|---|
credit_amount required |
decimal (string) | The credit, drawn down in full at the start. Allowed: > 0 and <= 1000000000000000. Unit: currency. |
upfront_charges |
decimal (string) default 0 |
Charges the consumer pays at the start (arrangement or valuation fees, for example). Charges paid later go into the payments they are paid with. Allowed: >= 0 and <= 1000000000000000. Unit: currency. |
payment_amounts required |
list of decimal (string) | 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. Each item: >= 0 and <= 1000000000000000. Unit: currency. |
payment_counts |
list of decimal (string) | 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. Each item: >= 1 and <= 1200. |
payment_frequency |
monthly | quarterly | semiannually | annually | weekly | fortnightly default monthly |
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 |
start_date |
date (YYYY-MM-DD) | 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. |
first_payment_date |
date (YYYY-MM-DD) | Date of the first payment. Later payments fall on the same day of the month (or the same weekday) at the payment frequency. |
include_schedule |
boolean default False |
Also return each payment with its time in years. |
options.rounding |
half_even | half_up | half_down | up | down | ceiling | floor | Rounding mode applied once to each result. Default half_up. |
options.decimals |
integer | Round results to this many digits after the decimal point. |
Result
Under result in the answer, next to exactness, precision, inputs, formula, references and warnings.
| Result | Type | Description |
|---|---|---|
aprc_percent | decimal (string) | The annual percentage rate of charge, in percent, rounded half up. Unit: percent. |
total_amount_payable | decimal (string) | Upfront charges plus all payments. Unit: currency. |
total_cost_of_credit | decimal (string) | Total amount payable minus the credit amount. Unit: currency. |
number_of_payments | integer | Number of payments. |
schedule | list of object | Each payment with its time from the drawdown (when include_schedule is true). |
Examples
Commission example 1: €200,000, €4,000 fee, 240 × €1,432.86 a month
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": ["1432.86"],
"payment_counts": ["240"]
}'
{
"calculator": "finance/apr/eu-aprc@1",
"result": {
"aprc_percent": "6.4",
"total_amount_payable": "347886.4",
"total_cost_of_credit": "147886.4",
"number_of_payments": 240
},
"exactness": {
"aprc_percent": "rounded",
"total_amount_payable": "exact",
"total_cost_of_credit": "exact"
},
"precision": {
"rounding": "half_up",
"decimals": 1
},
"inputs": {
"credit_amount": "200000",
"upfront_charges": "4000",
"payment_amounts": [
"1432.86"
],
"payment_counts": [
"240"
],
"payment_frequency": "monthly",
"include_schedule": false
},
"formula": "credit − upfront charges = Σ P_j (1 + X)^(−t_j), t_j in years; APRC = X × 100",
"references": [
{
"title": "Directive 2014/17/EU (Mortgage Credit Directive), Annex I: calculation of the APRC",
"url": "https://www.legislation.gov.uk/eudr/2014/17/annex/I"
},
{
"title": "Directive (EU) 2023/2225 (Consumer Credit Directive), Annex III, which replaces Directive 2008/48/EC from 20 November 2026 with the same equation and day count",
"url": "https://eur-lex.europa.eu/eli/dir/2023/2225/oj/eng"
},
{
"title": "Directive 2008/48/EC (Consumer Credit Directive), Annex I (until 19 November 2026)",
"url": "https://eur-lex.europa.eu/legal-content/EN/TXT/HTML/?uri=CELEX:02008L0048-20231230"
},
{
"title": "European Commission: examples for the calculation of the APRC (2015)",
"url": "https://commission.europa.eu/system/files/2016-11/aprc-examples-calculation_en.pdf"
},
{
"title": "FCA Handbook MCOB 10A: annual percentage rate of charge",
"url": "https://www.handbook.fca.org.uk/handbook/MCOB/10A/2.html"
}
],
"warnings": []
}
The same loan signed 12 January 2012, paid on the 15th from February 2012
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}
}'
{
"calculator": "finance/apr/eu-aprc@1",
"result": {
"aprc_percent": "6.434185",
"total_amount_payable": "348056.800000",
"total_cost_of_credit": "148056.800000",
"number_of_payments": 240
},
"exactness": {
"aprc_percent": "rounded",
"total_amount_payable": "exact",
"total_cost_of_credit": "exact"
},
"precision": {
"rounding": "half_up",
"decimals": 6
},
"inputs": {
"credit_amount": "200000",
"upfront_charges": "4000",
"payment_amounts": [
"1433.57"
],
"payment_counts": [
"240"
],
"payment_frequency": "monthly",
"start_date": "2012-01-12",
"first_payment_date": "2012-02-15",
"include_schedule": false
},
"formula": "credit − upfront charges = Σ P_j (1 + X)^(−t_j), t_j in years; APRC = X × 100",
"references": [
{
"title": "Directive 2014/17/EU (Mortgage Credit Directive), Annex I: calculation of the APRC",
"url": "https://www.legislation.gov.uk/eudr/2014/17/annex/I"
},
{
"title": "Directive (EU) 2023/2225 (Consumer Credit Directive), Annex III, which replaces Directive 2008/48/EC from 20 November 2026 with the same equation and day count",
"url": "https://eur-lex.europa.eu/eli/dir/2023/2225/oj/eng"
},
{
"title": "Directive 2008/48/EC (Consumer Credit Directive), Annex I (until 19 November 2026)",
"url": "https://eur-lex.europa.eu/legal-content/EN/TXT/HTML/?uri=CELEX:02008L0048-20231230"
},
{
"title": "European Commission: examples for the calculation of the APRC (2015)",
"url": "https://commission.europa.eu/system/files/2016-11/aprc-examples-calculation_en.pdf"
},
{
"title": "FCA Handbook MCOB 10A: annual percentage rate of charge",
"url": "https://www.handbook.fca.org.uk/handbook/MCOB/10A/2.html"
}
],
"warnings": []
}
References
- Directive 2014/17/EU (Mortgage Credit Directive), Annex I: calculation of the APRC
- Directive (EU) 2023/2225 (Consumer Credit Directive), Annex III, which replaces Directive 2008/48/EC from 20 November 2026 with the same equation and day count
- Directive 2008/48/EC (Consumer Credit Directive), Annex I (until 19 November 2026)
- European Commission: examples for the calculation of the APRC (2015)
- FCA Handbook MCOB 10A: annual percentage rate of charge
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.
Errors share one format; see errors. Billing, retries and batches work the same for every endpoint.