API reference
Base URL https://api.curatedapi.com. Every calculator is a POST
with a JSON body, and the same calculator is a tool on the MCP server. The machine-readable
version of this reference is openapi.json
(OpenAPI 3.1), and llms.txt summarises it for language models.
Quickstart
- Get an API key. Test keys (
capi_test_) give the same answers and are never billed. - Call a calculator. Send numbers as strings to keep every digit:
curl https://api.curatedapi.com/v1/calc/finance/loan/emi \
-H "Authorization: Bearer $CURATEDAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"principal": "250000",
"annual_rate_percent": "7.5",
"term_months": 240
}'
{
"emi": "2013.98",
"total_paid": "483356.89",
"total_interest": "233356.89",
"last_payment": "2015.67",
"number_of_payments": 240
}
The full answer also has exactness, precision, the inputs as
understood, the formula, references and any warnings. Each calculator's page below lists its
inputs and outputs, with examples.
Authentication
Send your key in the Authorization header: Authorization: Bearer capi_live_…
(or X-API-Key: capi_live_…).
- Live keys (
capi_live_) are billed. Use them from your server only; they are refused if sent from a web browser. - Test keys (
capi_test_) give the same answers, are never billed, and have their own monthly allowance. - Public keys (
capi_public_) are for web pages. They work only from the websites registered for them.
Numbers, precision and rounding
Send numbers as strings ("0.1") to keep every digit; plain JSON numbers are accepted
too. Results are computed exactly (or with certified high precision for roots, logarithms and
the like) and rounded once. Most calculators take an options object:
"options": {"decimals": 2, "rounding": "half_up"}
"options": {"significant_digits": 10}
Rounding modes: half_even (also called banker's rounding), half_up,
half_down, up (away from zero), down (toward zero), ceiling and floor.
Most calculators default to half_even; the billing and regulated APR calculators default to
half_up, and a few (money rounding and splitting, dates, rounding) take no options because
their inputs set the rounding. Each calculator's page gives its default.
Each response's exactness says, for every single decimal result, whether it is
exact, rounded, rounded_uncertified (the last digit could not be
proven; a warning says so) or underflow (below 1e-100, reported as 0). Lists and schedule
rows are rounded the same way and are not listed there.
Versions
POST /v1/calc/finance/loan/emi runs the latest version. Append @1 to pin
version 1. Any change in behaviour gets a new version, and old versions keep working, so your
numbers never change silently. Each response names the version that ran in calculator.
Billing and usage
Only successful (2xx) calls with live or public keys are billable. Errors, test keys and idempotent retries are free. Every response includes:
X-Request-Id | The request's ID, as recorded in your usage ledger. |
X-Billable | true if this call was billed. |
X-Usage-Count / X-Usage-Limit | Units used and included this month (UTC); with a spend cap, the limit is the units the cap allows. |
RateLimit-Limit / -Remaining / -Reset | Your burst allowance; a 429 response also has Retry-After. |
GET /v1/account shows your plan, usage and statement, GET /v1/account/usage breaks
it down by day and endpoint, and GET /v1/account/usage/events.csv lists every recorded call, so
you can reconcile against your own logs. Every billable call is recorded. Failed calls and
idempotent retries, which are free, are recorded up to 10,000 a day for an account; past that
they are answered as usual but not listed.
Spend cap. To make sure a month never costs more than you plan, set a cap with
PUT /v1/account/spend-cap and a live key, for example {"spend_cap_cents": 5000}
for a month of at most $50 (or €50 on a euro plan), the plan's price included. Requests that would go past it get
429 SPEND_CAP_REACHED and are not billed. With a cap, or on a plan without overage, we
email you when 80% of the month's limit is used and when it is reached. A key can add or lower the
cap but not raise or remove it, so a leaked key cannot lift its own limit; raise or remove it under
Billing in the dashboard, which asks for your password.
Invoices. A paid plan is billed by billing month, starting on the day you buy it and on the same date each month after, at 00:00 UTC. The plan's price is charged at the start of each billing month, and usage beyond what it includes, from the same ledger, with the next month's price. The Free plan resets on the 1st of each month (UTC). With a saved card each charge is made to it; otherwise an invoice is emailed to be paid by card. Every invoice is under Billing in the dashboard, and the terms have the details.
Limits
Each plan allows a number of calls a second (listed under
pricing), with a burst on top;
GET /v1/account shows both for your plan. Live, test and public keys are counted
separately, and all of an account's keys of one kind share one allowance. A call over the limit gets 429 RATE_LIMITED with
Retry-After and is not billed.
- Slow calculations count for more. Most calculations take a few milliseconds and count as one call toward the limit. One that runs longer than 0.1 seconds counts as one call for each full 0.1 seconds it ran, so a 3-second calculation counts as 30. This is only about the rate limit: the call is billed as usual, or not at all if it failed.
- An account's calculations take turns. So that one account's heavy work cannot
slow down everyone else's, at most 3 of an
account's calculations run at a time. More sent at the same moment wait for
the ones before them, which takes a few milliseconds unless those are slow. One still waiting
when its time limit passes gets
429 RATE_LIMITEDand is not billed. - Time. A calculation has 2 to 5 seconds, depending on the endpoint. One that takes longer is stopped
with
503 CALCULATION_TIMEOUTand is not billed.
Safe retries
Send an Idempotency-Key header (a UUID is ideal). Repeating a request with the same
key and the same body within 24 hours returns the same result with
Idempotent-Replayed: true and is not billed again. Reusing a key with a different body
returns 422 IDEMPOTENCY_KEY_REUSED.
Batches
POST /v1/batch runs up to 25 calls in one request (no more than your plan's burst),
with a live or test key:
{"requests": [
{"endpoint": "calc/finance/loan/emi", "input": {"principal": "250000", "annual_rate_percent": "7.5", "term_months": 240}},
{"endpoint": "calc/finance/loan/emi@1", "input": {"principal": "250000", "annual_rate_percent": "7.5", "term_months": 120}}
]}
The answer has one entry per call, in the same order:
{"results": [{"index": 0, "status": 200, "request_id": "…", "billable": true, "body": {…}}, …]},
where body is exactly what the call would have answered on its own, result or error.
Each call is metered, billed, limited by your quota and spend cap, and counted against your rate
limit as if sent separately, so a batch saves round trips, not money. Send an
Idempotency-Key with the batch: call i then uses <key>:<i>,
so repeating a batch after a lost connection replays the calls that already ran, free.
Signed receipts
Add ?receipt=true to a call, or to /v1/batch for every call in it, and
the answer gains a receipt: a JSON Web Token signed with Ed25519 (JOSE algorithm
EdDSA, RFC 8037). Keep it with your records. It shows anyone, without having to
trust your systems or ours, what curatedapi answered for which inputs, and when. Receipts cost
nothing extra. For the MCP server, add ?receipt=true to its URL.
curl -X POST "https://api.curatedapi.com/v1/calc/finance/loan/emi?receipt=true" \
-H "Authorization: Bearer $CURATEDAPI_KEY" -H "Content-Type: application/json" \
-d '{"principal": "250000", "annual_rate_percent": "7.5", "term_months": 240}'
The receipt's claims:
iss | https://api.curatedapi.com |
iat | When the request arrived, in seconds since 1970 (UTC). |
jti | The request ID, as in X-Request-Id and your usage ledger. |
endpoint | The endpoint and the version that ran, such as calc/finance/loan/emi@1. |
date | The request's date (UTC), which calculators use as "today". |
response | The whole answer without the receipt: result, exactness, precision, inputs as understood, formula, references and warnings. |
To check a receipt, send it to POST /v1/receipts/verify. That needs no key and is free:
curl -X POST https://api.curatedapi.com/v1/receipts/verify -H "Content-Type: application/json" \
-d '{"receipt": "eyJ..."}'
The answer is {"valid": true, "key_id": "…", "header": {…}, "claims": {…}}, or
{"valid": false, "reason": "…"}. You can also check receipts yourself, offline, with
our public keys at https://api.curatedapi.com/.well-known/jwks.json.
A receipt's header names its key in kid, which is the key's RFC 7638 thumbprint. Any JOSE
library that supports EdDSA works. Without one, in Python with the cryptography
package:
import base64
import json
import urllib.request
from cryptography.hazmat.primitives.asymmetric.ed25519 import Ed25519PublicKey
def b64url_decode(text):
return base64.urlsafe_b64decode(text + "=" * (-len(text) % 4))
def verify_receipt(receipt, jwks):
"""The receipt's claims if our key signed it; raises an exception otherwise."""
header_b64, payload_b64, signature_b64 = receipt.split(".")
header = json.loads(b64url_decode(header_b64))
if header["alg"] != "EdDSA":
raise ValueError("not a curatedapi receipt")
keys = {k["kid"]: k for k in jwks["keys"]}
if header["kid"] not in keys:
raise ValueError("signed with a key that is not curatedapi's")
public_key = Ed25519PublicKey.from_public_bytes(b64url_decode(keys[header["kid"]]["x"]))
signed = f"{header_b64}.{payload_b64}".encode("ascii")
public_key.verify(b64url_decode(signature_b64), signed) # raises InvalidSignature
return json.loads(b64url_decode(payload_b64))
jwks = json.load(urllib.request.urlopen("https://api.curatedapi.com/.well-known/jwks.json"))
claims = verify_receipt(answer["receipt"], jwks) # answer: the JSON of a call with ?receipt=true
print(claims["endpoint"], claims["response"]["result"])
In Node.js, with nothing to install:
import { createPublicKey, verify } from "node:crypto";
// The receipt's claims if our key signed it; throws otherwise. Node 18 or later.
export function verifyReceipt(receipt, jwks) {
const [headerB64, payloadB64, signatureB64] = receipt.split(".");
const header = JSON.parse(Buffer.from(headerB64, "base64url"));
if (header.alg !== "EdDSA") throw new Error("not a curatedapi receipt");
const jwk = jwks.keys.find((k) => k.kid === header.kid);
if (!jwk) throw new Error("signed with a key that is not curatedapi's");
const key = createPublicKey({ key: { kty: jwk.kty, crv: jwk.crv, x: jwk.x }, format: "jwk" });
const signed = Buffer.from(`${headerB64}.${payloadB64}`, "ascii");
if (!verify(null, signed, key, Buffer.from(signatureB64, "base64url"))) {
throw new Error("the signature does not match: the receipt was changed");
}
return JSON.parse(Buffer.from(payloadB64, "base64url"));
}
const jwks = await (await fetch("https://api.curatedapi.com/.well-known/jwks.json")).json();
const claims = verifyReceipt(answer.receipt, jwks); // answer: the JSON of a call with ?receipt=true
console.log(claims.endpoint, claims.response.result);
When we replace the signing key, the old key stays in the key set, so the receipts you hold keep verifying.
Errors
Errors share one format, and none is billed:
{"error": {"code": "OUT_OF_RANGE", "message": "term_months must be at least 1",
"details": [{"field": "term_months", "code": "OUT_OF_RANGE", "message": "..."}],
"request_id": "…"}}
| Code | Status | Meaning |
|---|---|---|
INVALID_JSON | 400 | The request body is not valid JSON. |
UNAUTHENTICATED | 401 | A valid API key is required. |
FORBIDDEN | 403 | This key may not be used for this request. |
NOT_FOUND | 404 | There is no such endpoint or resource. |
METHOD_NOT_ALLOWED | 405 | This HTTP method is not supported here. |
PAYLOAD_TOO_LARGE | 413 | The request body is larger than the limit. |
UNSUPPORTED_MEDIA_TYPE | 415 | Send the body as application/json. |
IDEMPOTENCY_KEY_REUSED | 422 | This Idempotency-Key was already used with a different request. |
INVALID_INPUT | 422 | An input value is not valid. |
MISSING_FIELD | 422 | A required input is missing. |
OUT_OF_RANGE | 422 | An input or the result is outside the supported range. |
UNDEFINED_RESULT | 422 | The result is mathematically undefined for these inputs. |
UNKNOWN_FIELD | 422 | The request contains a field this endpoint does not accept. |
QUOTA_EXCEEDED | 429 | The plan's monthly quota is used up. |
RATE_LIMITED | 429 | Too many requests; slow down and retry after the indicated time. |
SPEND_CAP_REACHED | 429 | The account's monthly spend cap is reached. |
INTERNAL_ERROR | 500 | Something went wrong on our side; nothing was billed. |
CALCULATION_TIMEOUT | 503 | The calculation took too long and was stopped. |
SERVICE_UNAVAILABLE | 503 | The service could not record the request; nothing was billed. |
MCP server for AI agents
Point any MCP client at https://mcp.curatedapi.com (streamable HTTP) with your key in the
Authorization header. Every calculator and validator is a tool (each one's page gives its name), with the
same inputs, outputs and billing as the REST API.
Each tool call is billed, including a repeat with the same arguments. To retry safely, give the
call an idempotency key: put it in the call's _meta as
"com.curatedapi/idempotencyKey", or send an Idempotency-Key header. A
repeat with the same key and the same arguments within 24 hours is not billed again, as on REST.
Widgets
Put any calculator on your own website with two lines of HTML. The widget draws the form, calls the API from your visitor's browser with your public key, and shows the result.
<div data-curatedapi-widget="finance/loan/emi" data-key="capi_public_…"></div> <script src="https://widgets.curatedapi.com/v1/widget.js" async></script>
data-theme | light, dark or auto (the default: follows the visitor's setting). |
data-accent | A colour such as #1f6feb for the button. |
data-title | The heading, instead of the calculator's title. |
data-decimals | Decimal places of the results, for calculators that take a decimals option. |
A page can hold several widgets, and widgets added later are found automatically;
window.curatedapi.mount(element) draws one explicitly, once however often it is called.
Keys and websites. A public key (capi_public_) works only from the
websites registered for it, by exact origin: https://example.com and
https://www.example.com are different. From any other site the API answers
403. Create one under Keys in the dashboard and list
your sites. Never put a live or test key in a page: anyone can read it, and the widget refuses
to send it.
Content-Security-Policy. Allow script-src https://widgets.curatedapi.com and
connect-src https://api.curatedapi.com. No 'unsafe-inline' or 'unsafe-eval'
is needed, and Trusted Types are fine.
Billing. A widget's calculations are billed like API calls, in the calculator's
normal units, and appear in your usage with channel widget. Loading the form is free,
errors are free, and a retry after a lost answer is not billed twice.
Privacy and accessibility. The widget sets no cookies, stores nothing and sends
no Referer; inputs go only to the API. It has real labels, announces results to screen
readers, works with the keyboard alone and at 320px wide, and meets WCAG AA contrast in both
themes.
E-invoice validation
The validators under /v1/validate/einvoice/ run the official rules of each standard,
unchanged: CEN's EN 16931 artefacts, OpenPeppol's BIS Billing 3.0 rules, KoSIT's XRechnung
configuration and the Factur-X / ZUGFeRD schemas and Schematron. Send the invoice XML as a JSON
string in xml (or, for Factur-X, the PDF as base64 in pdf). With
jq:
jq -Rs '{xml: .}' invoice.xml |
curl https://api.curatedapi.com/v1/validate/einvoice/xrechnung \
-H "Authorization: Bearer $CURATEDAPI_KEY" \
-H "Content-Type: application/json" \
--data-binary @-
An invoice that breaks a rule is still a successful call: the answer is HTTP 200 with
"valid": false and every finding, with the rule's ID, level, the rule owner's own
message and where in the document it applies. Errors make an invoice invalid; warnings and notices
do not. Each answer names the rule versions it used under rules.
A validation counts as 5 units of a plan's quota. XML may be up to 4 MiB and a PDF up to 6 MiB. Invoices are not stored or logged: the answer holds only the findings. Validators are not available to widgets.
Leases and depreciation
Five calculators under /v1/calc/accounting/ return a full schedule in one call:
- IFRS 16 and ASC 842 (finance or operating) lease accounting for the lessee: the lease liability and right-of-use asset at commencement, then interest, depreciation or the straight-line lease cost, and both balances for every period.
- MACRS US tax depreciation with the IRS tables, after Section 179 and bonus depreciation.
- Schedule II book depreciation (SLM or WDV) and income-tax depreciation on a block of assets for India.
A lease is described by its first payment, how many payments there are and how often, whether they are paid in advance or in arrears, and the annual discount rate. Costs and incentives at the start are optional. A three-year office lease paid monthly in advance:
curl https://api.curatedapi.com/v1/calc/accounting/lease/ifrs16 \
-H "Authorization: Bearer $CURATEDAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"payment": "2500",
"payments_per_year": "12",
"number_of_payments": 36,
"timing": "advance",
"discount_rate_percent": "5",
"initial_direct_costs": "1000",
"commencement_date": "2026-11-01"
}'
The answer, with the schedule shortened to its first two months:
{
"periodic_rate_percent": "0.4166666666667",
"initial_liability": "81261.81",
"initial_rou_asset": "84761.81",
"total_payments": "90000.00",
"total_interest": "6238.19",
"rou_asset_end_of_term": "0.00",
"total_depreciation": "84761.81",
"schedule": [
{
"period": 1,
"start": "2026-11-01",
"end": "2026-11-30",
"payment": "2500.00",
"interest": "338.59",
"liability": "81600.40",
"depreciation": "2354.49",
"rou_asset": "82407.32"
},
{
"period": 2,
"start": "2026-12-01",
"end": "2026-12-31",
"payment": "2500.00",
"interest": "329.58",
"liability": "79429.98",
"depreciation": "2354.49",
"rou_asset": "80052.83"
},
"…"
]
}
Every row of a schedule adds up: the previous balance, plus the period's interest, less its
payment, is the new balance, and the last row ends at exactly zero. By default each period's interest and depreciation is
rounded and the next period works from the rounded balance, as when the entries are booked; pass
"schedule_rounding": "exact" to get each exact balance rounded instead. Choose the
currency's decimals with options.decimals (2 by default). Each calculator page lists
the standard's worked examples it reproduces.
All endpoints
103 endpoints: calculators and e-invoice validators. Each page has the inputs, outputs and worked examples.
Finance
| Black-76 calculator for options on futures | POST /v1/calc/finance/black-76 |
The Black (1976) price and Greeks of a European option on a future or forward: commodity and bond futures options, caps, floors and swaptions. |
|---|---|---|
| Black-Scholes option price and Greeks calculator | POST /v1/calc/finance/black-scholes |
The Black-Scholes-Merton price of a European call or put with delta, gamma, vega, theta and rho, correct to the last digit shown. |
| Bond duration and convexity calculator | POST /v1/calc/finance/bond-duration-convexity |
The price of a coupon bond at a yield, with its Macaulay and modified duration, convexity and DV01, for any settlement date. |
| Compound interest calculator | POST /v1/calc/finance/compound-interest |
Future value of a lump sum with annual, monthly, daily or continuous compounding, plus the effective annual rate (APY). |
| EU and UK APRC calculator | POST /v1/calc/finance/apr/eu-aprc |
Annual percentage rate of charge (APRC, the UK's APR) for consumer and mortgage credit, by the EU directives' equation and day count. |
| Extra mortgage payment calculator | POST /v1/calc/finance/extra-payments |
How much sooner a loan is paid off, and how much interest is saved, by paying extra each month or making one lump-sum payment. |
| FHA mortgage insurance (MIP) calculator | POST /v1/calc/finance/fha-mip |
The upfront and annual mortgage insurance premium on an FHA loan, from HUD's current rate tables, and how long the annual premium is charged. |
| Implied volatility calculator | POST /v1/calc/finance/implied-volatility |
The volatility at which the Black-Scholes-Merton formula gives an option's market price, pinned between proven bounds. |
| Internal rate of return (IRR) calculator | POST /v1/calc/finance/irr |
Internal rate of return of periodic cash flows, with every IRR reported when there is more than one. |
| Loan EMI calculator | POST /v1/calc/finance/loan/emi |
Monthly instalment (EMI), total interest and an exact amortization schedule for a fixed-rate loan. |
| Mortgage affordability calculator | POST /v1/calc/finance/mortgage-affordability |
The largest loan and home price an income supports, from housing and debt-to-income ratios you set (28% and 36% by default). |
| Mortgage calculator | POST /v1/calc/finance/mortgage |
Monthly mortgage payment including property tax, insurance, HOA dues and PMI, with an exact amortization schedule. |
| Net present value (NPV) calculator | POST /v1/calc/finance/npv |
Net present value of a series of periodic cash flows at a discount rate. |
| Refinance break-even calculator | POST /v1/calc/finance/refinance-break-even |
How many months of lower payments it takes to earn back the closing costs of a refinance, and the difference in total cost over the life of the loans. |
| Rent or buy calculator | POST /v1/calc/finance/rent-vs-buy |
The net cost of renting against buying a home over a number of years, from assumptions you set, with the first year in which buying comes out ahead. |
| Return on investment (ROI) calculator | POST /v1/calc/finance/roi |
Gain, ROI percentage and annualized return (CAGR) of an investment. |
| Savings goal calculator | POST /v1/calc/finance/savings-goal |
How much to save each month (or week, or year) to reach a goal, or how long it takes with a given contribution. |
| Simple interest calculator | POST /v1/calc/finance/simple-interest |
Simple interest for a number of years or between two dates, with standard day-count conventions (Actual/365, Actual/360, Actual/Actual, 30/360, 30E/360). |
| US APR calculator (Truth in Lending, Regulation Z) | POST /v1/calc/finance/apr/us-reg-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. |
| USDA loan guarantee fee calculator | POST /v1/calc/finance/usda-guarantee-fee |
The upfront guarantee fee and the annual fee on a USDA guaranteed home loan, at the rates USDA Rural Development set for fiscal year 2027. |
| VA funding fee calculator | POST /v1/calc/finance/va-funding-fee |
The VA funding fee on a home loan, from the Department of Veterans Affairs' current rate chart, by loan type, down payment and first or later use. |
| Yield to call calculator | POST /v1/calc/finance/yield-to-call |
The yield of a callable bond if the issuer redeems it on the call date at the call price, found as a proven root of the price equation. |
Excel functions
| Excel CUMIPMT function: interest paid between two periods | POST /v1/calc/excel/cumipmt |
Total interest paid on a loan from one period to another, as Excel's CUMIPMT. |
|---|---|---|
| Excel CUMPRINC function: principal paid between two periods | POST /v1/calc/excel/cumprinc |
Total principal repaid from one period to another, as Excel's CUMPRINC. |
| Excel DAYS360 function: days on a 360-day year | POST /v1/calc/excel/days360 |
Days between two dates on a 360-day year, by the US (NASD) or European method, as Excel's DAYS360. |
| Excel DB function: fixed-declining balance depreciation | POST /v1/calc/excel/db |
Fixed-declining balance depreciation for one period, as Excel's DB, including its three-decimal rate and part-year first and last periods. |
| Excel DDB function: double-declining balance depreciation | POST /v1/calc/excel/ddb |
Double-declining (or any factor) balance depreciation for one period, as Excel's DDB. |
| Excel DURATION function: Macaulay duration of a bond | POST /v1/calc/excel/duration |
The Macaulay duration of a bond with periodic coupons, as Excel's DURATION: the average time to its payments, weighted by their present value. |
| Excel EDATE function: same day, months later | POST /v1/calc/excel/edate |
The same day of the month a number of months before or after a date, as Excel's EDATE. |
| Excel EFFECT function: effective annual rate | POST /v1/calc/excel/effect |
The effective annual rate from a nominal rate and compounding periods, as Excel's EFFECT. |
| Excel EOMONTH function: end of month | POST /v1/calc/excel/eomonth |
The last day of the month a number of months before or after a date, as Excel's EOMONTH. |
| Excel FV function: future value | POST /v1/calc/excel/fv |
The future value of an investment with equal payments, the same as Excel's FV. |
| Excel IPMT function: interest part of a payment | POST /v1/calc/excel/ipmt |
The interest paid in one period of a loan, the same as Excel's IPMT. |
| Excel MDURATION function: modified duration of a bond | POST /v1/calc/excel/mduration |
The modified Macaulay duration of a bond with periodic coupons, as Excel's MDURATION: the percentage change in price for a change in yield. |
| Excel MIRR function: modified internal rate of return | POST /v1/calc/excel/mirr |
The modified IRR of periodic cash flows with separate finance and reinvestment rates, as Excel's MIRR. |
| Excel NETWORKDAYS function: working days between dates | POST /v1/calc/excel/networkdays |
Working days between two dates, both included, with holidays and any weekend, as Excel's NETWORKDAYS and NETWORKDAYS.INTL. |
| Excel NOMINAL function: nominal annual rate | POST /v1/calc/excel/nominal |
The nominal annual rate from an effective rate, as Excel's NOMINAL. |
| Excel NPER function: number of periods | POST /v1/calc/excel/nper |
How many periods it takes to pay off a loan or reach a goal, as Excel's NPER. |
| Excel PMT function: loan payment | POST /v1/calc/excel/pmt |
The payment per period for a loan or an investment, the same as Excel's PMT. |
| Excel PPMT function: principal part of a payment | POST /v1/calc/excel/ppmt |
The principal repaid in one period of a loan, the same as Excel's PPMT. |
| Excel PRICE function: bond price per 100 face value | POST /v1/calc/excel/price |
The clean price per 100 of a bond paying periodic coupons, from its yield, as Excel's PRICE. |
| Excel PV function: present value | POST /v1/calc/excel/pv |
The present value of a series of equal payments, the same as Excel's PV. |
| Excel RATE function: interest rate per period | POST /v1/calc/excel/rate |
The interest rate per period of a loan or annuity, as Excel's RATE, proven correct to the last digit. |
| Excel SLN function: straight-line depreciation | POST /v1/calc/excel/sln |
Straight-line depreciation for one period, as Excel's SLN. |
| Excel SYD function: sum-of-years-digits depreciation | POST /v1/calc/excel/syd |
Sum-of-years' digits depreciation for one period, as Excel's SYD. |
| Excel VDB function: variable declining balance depreciation | POST /v1/calc/excel/vdb |
Declining-balance depreciation between any two points in an asset's life, switching to straight line, as Excel's VDB. |
| Excel WORKDAY function: date after working days | POST /v1/calc/excel/workday |
The date a number of working days before or after a date, with holidays and any weekend, as Excel's WORKDAY and WORKDAY.INTL. |
| Excel XIRR function: IRR of cash flows on any dates | POST /v1/calc/excel/xirr |
The annual rate of return of cash flows on any dates, as Excel's XIRR, proven correct to the last digit. |
| Excel XNPV function: net present value of dated cash flows | POST /v1/calc/excel/xnpv |
Net present value of cash flows on any dates, the same as Excel's XNPV. |
| Excel YEARFRAC function: fraction of a year between dates | POST /v1/calc/excel/yearfrac |
The fraction of a year between two dates under Excel's five day-count bases, including Excel's own actual/actual rule. |
| Excel YIELD function: bond yield from price | POST /v1/calc/excel/yield |
The yield of a bond paying periodic coupons, from its price, as Excel's YIELD, proven correct to the last digit. |
Late payments
| EU late payment interest calculator (Directive 2011/7) | POST /v1/calc/payments/late-interest/eu |
Statutory interest on a late business invoice under the EU Late Payment Directive: the ECB rate plus at least 8 points, set each half-year, plus €40. |
|---|---|---|
| MSME delayed payment interest calculator (India) | POST /v1/calc/payments/late-interest/india-msme |
Interest owed to a micro or small enterprise for late payment under sections 15 and 16 of India's MSMED Act 2006: three times the RBI Bank Rate, compounded monthly. |
| Prompt Payment Act interest calculator | POST /v1/calc/payments/late-interest/us-prompt-payment |
The interest penalty a US federal agency owes on a late invoice under the Prompt Payment Act: the Treasury rate, compounded every 30 days on a 360-day year. |
| UK late payment interest calculator (8% over base) | POST /v1/calc/payments/late-interest/uk |
Statutory interest and fixed compensation on a late business invoice under the UK Late Payment of Commercial Debts (Interest) Act 1998. |
| Verzugszinsen calculator (§ 288 BGB, Germany) | POST /v1/calc/payments/late-interest/germany |
Verzugszinsen under § 288 BGB, half-year by half-year: the Basiszinssatz plus 9 points and the €40 fee between businesses, or plus 5 points with consumers. |
E-invoices
| EN 16931 validator (UBL and CII) | POST /v1/validate/einvoice/en16931 |
Check a UBL or CII invoice against the European e-invoicing standard EN 16931 with CEN's official rules. |
|---|---|---|
| Factur-X / ZUGFeRD validator | POST /v1/validate/einvoice/factur-x |
Check a Factur-X or ZUGFeRD 2 invoice, as a PDF or its XML, against the rules for its profile. |
| Peppol BIS 3.0 invoice validator | POST /v1/validate/einvoice/peppol-bis |
Check a UBL invoice or credit note against Peppol BIS Billing 3.0 with OpenPeppol's official rules. |
| XRechnung validator (KoSIT rules) | POST /v1/validate/einvoice/xrechnung |
Check an XRechnung 3.0 invoice the way German public buyers do, with KoSIT's official validator configuration. |
Accounting
| ASC 842 lease calculator: finance and operating leases | POST /v1/calc/accounting/lease/asc842 |
Lessee accounting under US GAAP ASC 842: lease liability, right-of-use asset and the schedule for a finance or an operating lease. |
|---|---|---|
| IFRS 16 lease calculator: liability and right-of-use asset | POST /v1/calc/accounting/lease/ifrs16 |
Lessee accounting under IFRS 16: the initial lease liability and right-of-use asset, and a schedule of interest, depreciation and balances. |
| Indian income-tax depreciation | POST /v1/calc/accounting/depreciation/india-income-tax |
Tax depreciation on a block of assets: opening WDV plus additions less sale proceeds, with half the rate for additions used under 180 days. |
| MACRS depreciation calculator (IRS tables, GDS) | POST /v1/calc/accounting/depreciation/macrs |
US tax depreciation under MACRS (GDS) with the IRS percentage tables, Section 179 and bonus depreciation. |
| Schedule II depreciation (India) | POST /v1/calc/accounting/depreciation/india-companies-act |
Book depreciation for Indian companies over the Schedule II useful life, straight line (SLM) or written down value (WDV), pro rata by days. |
Number checks
| Australian Business Number (ABN) check | POST /v1/calc/check/abn |
Check an 11-digit Australian Business Number with the Australian Business Register's modulus 89 rule. |
|---|---|---|
| BIC (SWIFT code) check | POST /v1/calc/check/bic |
Check the structure of a BIC (SWIFT code) under ISO 9362 and split it into party, country and branch. |
| CUSIP check | POST /v1/calc/check/cusip |
Check the length and check digit of a CUSIP and split it into issuer, issue and check digit. |
| GSTIN check (India) | POST /v1/calc/check/india-gstin |
Check the state code, structure and check character of an Indian GSTIN and read the PAN inside it. |
| IBAN check | POST /v1/calc/check/iban |
Check an IBAN's country, length, structure and check digits against the SWIFT IBAN registry, and say exactly what is wrong. |
| ISIN check | POST /v1/calc/check/isin |
Check the structure and check digit of an ISIN (ISO 6166) and split it into prefix, national number and check digit. |
| LEI check | POST /v1/calc/check/lei |
Check the length and check digits of a Legal Entity Identifier (ISO 17442). |
| PAN check (India) | POST /v1/calc/check/india-pan |
Check the structure of an Indian Permanent Account Number and read the kind of holder from its fourth character. |
| US bank routing number check | POST /v1/calc/check/us-routing-number |
Check the check digit and the first two digits of a US ABA routing number. |
| VAT number check | POST /v1/calc/check/vat-number |
Check the structure and check digit of a VAT number from any EU member state, Northern Ireland, Great Britain, Switzerland or Norway. |
VAT and GST
| VAT and GST calculator | POST /v1/calc/tax/vat |
VAT or GST on one amount or a whole invoice, added or taken out of tax-inclusive prices, with the per-rate rounding EN 16931 e-invoices require. |
|---|---|---|
| VAT and GST rates by country | POST /v1/calc/tax/vat-rates |
The standard and reduced VAT or GST rates of a country, with the official page they were read from and the day they were last checked. |
Billing and pricing
| Stacked discount calculator | POST /v1/calc/billing/discounts |
Final price after several percentage and fixed-amount discounts, applied in order like Stripe's stacked coupons, with an optional cap. |
|---|---|---|
| Subscription proration calculator | POST /v1/calc/billing/proration |
Credit for unused time and charge for the remaining time when a subscription changes plan mid-period, prorated to the second like Stripe, or by hour, day or week. |
| Tiered pricing calculator | POST /v1/calc/billing/tiered-price |
Price of a quantity under graduated or volume tiers, with optional flat fees, exactly as Stripe bills tiered prices. |
Money and currencies
| Currency rounding calculator | POST /v1/calc/money/round |
Round an amount to its currency's minor unit (ISO 4217: 2 decimals for EUR, 0 for JPY, 3 for KWD) and to a country's cash rounding rule, such as 0.05 in Canada. |
|---|---|---|
| Money splitter | POST /v1/calc/money/allocate |
Split an amount by ratios or into equal parts so the shares are whole cents and add up exactly to the amount. |
Dates and time
| Add or subtract time from a date | POST /v1/calc/date/add |
Add or subtract years, months, weeks, days, business days or hours to a date or date-time, with month-end and daylight-saving rules spelled out. |
|---|---|---|
| Age calculator | POST /v1/calc/date/age |
Exact age in years, months and days, plus the next birthday, with an explicit rule for 29 February birthdays. |
| Date difference calculator | POST /v1/calc/date/difference |
Days, weeks, months, years and business days between two dates, or the exact time between two date-times across time zones and daylight saving changes. |
| Public holidays by country and year | POST /v1/calc/date/holidays |
The public holidays of a country or region in a year, worked out from the rules in its law, with the official source. |
| Time zone converter | POST /v1/calc/date/timezone-convert |
A moment in up to 25 time zones at once, with each zone's UTC offset and whether daylight saving time applies, from the IANA time zone database. |
| Working days calculator with public holidays | POST /v1/calc/date/working-days |
Working days between two dates, or the date a number of working days away, leaving out weekends and a country's public holidays. |
| Working hours and SLA deadline calculator | POST /v1/calc/date/working-hours |
The deadline a number of working hours after a start, or the working time between two moments, with office hours, weekends, public holidays and time zones. |
Math
| Expression calculator | POST /v1/calc/math/expression |
Evaluate an arithmetic expression exactly, with functions like sqrt, ln, sin and factorial. |
|---|---|---|
| Fraction calculator | POST /v1/calc/math/fraction |
Add, subtract, multiply, divide and simplify fractions and mixed numbers, with the exact repeating decimal. |
| Percentage calculator | POST /v1/calc/math/percentage |
Percent of a number, what percent one number is of another, percent change, percent difference, and increase or decrease by a percent. |
| Rounding calculator | POST /v1/calc/math/rounding |
Round a number to decimal places, significant digits or a multiple, with any of seven rounding rules. |
| Scientific calculator | POST /v1/calc/math/scientific |
Roots, powers, logarithms, exponentials, trig and hyperbolic functions, and factorials, correctly rounded to up to 50 significant digits. |
| Statistics calculator | POST /v1/calc/math/statistics |
Mean, median, mode, range, variance and standard deviation (population and sample) of a list of numbers. |
Unit conversion
| Data size converter | POST /v1/calc/units/data-size |
Convert between bits, bytes and their decimal (kB, MB) and binary (KiB, MiB) multiples. |
|---|---|---|
| Length converter | POST /v1/calc/units/length |
Convert between metric, imperial/US, nautical and astronomical lengths. |
| Mass and weight converter | POST /v1/calc/units/mass |
Convert between metric, avoirdupois (pounds and ounces), troy and carat units. |
| Temperature converter | POST /v1/calc/units/temperature |
Convert temperatures between Celsius, Fahrenheit, kelvin and Rankine. |
| Volume converter | POST /v1/calc/units/volume |
Convert between metric, US customary, imperial and cubic units of volume. |
Everyday
| Discount calculator | POST /v1/calc/everyday/discount |
Sale price after a percentage or fixed discount, an optional stacked second discount and sales tax. |
|---|---|---|
| Tip and bill split calculator | POST /v1/calc/everyday/tip |
Tip amount, total and a fair split between people where the shares add up exactly to the bill. |
Health
| BMI calculator | POST /v1/calc/health/bmi |
Body mass index for adults from weight and height in metric or imperial units, with the WHO/CDC weight category and the healthy weight range for that height. |
|---|