curatedapi
Browse the docs

Guides

Finance

Excel functions

Late payments

E-invoices

Accounting

Number checks

VAT and GST

Billing and pricing

Money and currencies

Dates and time

Math

Unit conversion

Everyday

Health

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

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).

InputTypeDescription
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.

ResultTypeDescription
aprc_percentdecimal (string)The annual percentage rate of charge, in percent, rounded half up. Unit: percent.
total_amount_payabledecimal (string)Upfront charges plus all payments. Unit: currency.
total_cost_of_creditdecimal (string)Total amount payable minus the credit amount. Unit: currency.
number_of_paymentsintegerNumber of payments.
schedulelist of objectEach 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

Requestcurl
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"]
  }'
200 OKResponse
{
  "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

Requestcurl
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}
  }'
200 OKResponse
{
  "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

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.