QuickCalc
Developer Documentation v1

Free Public Calculator REST API

Integrate science-backed calculation models directly into your web, mobile, or backend apps. 100% free with zero authentication required.

No API Key
CORS Enabled
60 Req / Min
Clean JSON

API Overview & Base URL

All endpoints are accessible via HTTPS at https://quickcalc.cloud/api/v1/. Requests return JSON responses formatted with standard HTTP status codes.

Cross-Origin (CORS) Policy

Headers include Access-Control-Allow-Origin: *, enabling client-side fetch() calls directly from browser apps.

Fair-Use Rate Limiting

Unauthenticated requests are rate limited to 60 requests per minute per IP address. Response headers report remaining capacity.

Available Endpoints

GET/api/v1/bmi

Body Mass Index (BMI) API

Calculates BMI value, World Health Organization (WHO) category, and healthy weight ranges for given height and weight.

Query Parameters
ParameterTypeRequiredDescription
weightnumberYesBody weight (e.g. 70 or 154)
heightnumberYesHeight in cm (e.g. 175)
unitstringNo'metric' (default) or 'imperial'
heightFt / heightInnumberNoImperial height components (if unit=imperial)
Example Request
curl -X GET 'https://quickcalc.cloud/api/v1/bmi?weight=70&height=175'
Sample JSON Response (200 OK)
{
  "success": true,
  "data": {
    "bmi": 22.9,
    "category": "Normal",
    "healthyRange": {
      "minBmi": 18.5,
      "maxBmi": 24.9,
      "minWeightKg": 56.7,
      "maxWeightKg": 76.3
    },
    "inputs": {
      "weight": 70,
      "weightUnit": "kg",
      "height": 175,
      "heightUnit": "cm",
      "unitSystem": "metric"
    }
  },
  "meta": {
    "formula": "BMI = weight (kg) / [height (m)]²",
    "standard": "World Health Organization (WHO)",
    "privacy": "100% Stateless & Private — No data logged"
  }
}
GET/api/v1/loan

Loan & EMI Amortization API

Computes Equal Monthly Installments (EMI), total interest payable, and full annual amortization schedule.

Query Parameters
ParameterTypeRequiredDescription
principalnumberYesLoan principal amount (e.g. 250000)
annualRatenumberYesAnnual interest percentage (e.g. 6.5)
tenurenumberYesDuration period (e.g. 30)
tenureUnitstringNo'years' (default) or 'months'
Example Request
curl -X GET 'https://quickcalc.cloud/api/v1/loan?principal=250000&annualRate=6.5&tenure=30&tenureUnit=years'
Sample JSON Response (200 OK)
{
  "success": true,
  "data": {
    "monthlyEMI": 1579.99,
    "totalPayment": 568797.87,
    "totalInterestPayable": 318797.87,
    "inputs": {
      "principal": 250000,
      "annualRate": 6.5,
      "tenure": 30,
      "tenureUnit": "years"
    }
  },
  "meta": {
    "formula": "EMI = P × [r(1+r)ⁿ] / [(1+r)ⁿ - 1]",
    "standard": "Reducing-Balance Compound Amortization"
  }
}
GET/api/v1/percentage

Percentage & Change API

Calculates X% of Y, percentage increase/decrease, discount pricing, or part-to-whole proportions.

Query Parameters
ParameterTypeRequiredDescription
typestringNo'of' (default), 'change', 'discount', or 'proportion'
percent / totalnumbermode-dependentFor type='of': e.g. percent=20&total=150
initial / finalnumbermode-dependentFor type='change': e.g. initial=100&final=125
price / discountnumbermode-dependentFor type='discount': e.g. price=80&discount=25
Example Request
curl -X GET 'https://quickcalc.cloud/api/v1/percentage?type=change&initial=100&final=125'
Sample JSON Response (200 OK)
{
  "success": true,
  "data": {
    "type": "percentage_change",
    "percentChange": 25,
    "direction": "increase",
    "difference": 25,
    "inputs": {
      "initial": 100,
      "final": 125
    }
  },
  "meta": {
    "formula": "% Change = [(125 - 100) / 100] * 100 = 25%"
  }
}
GET/api/v1/currency

Live Currency Conversion API

Converts fiat currency amounts using real-time mid-market exchange rates without spreads or bank fees.

Query Parameters
ParameterTypeRequiredDescription
amountnumberNoAmount to convert (default 1)
fromstringYes3-letter source currency code (e.g. USD)
tostringYes3-letter target currency code (e.g. EUR)
Example Request
curl -X GET 'https://quickcalc.cloud/api/v1/currency?amount=100&from=USD&to=EUR'
Sample JSON Response (200 OK)
{
  "success": true,
  "data": {
    "amount": 100,
    "fromCurrency": "USD",
    "toCurrency": "EUR",
    "convertedAmount": 91.74,
    "exchangeRate": 0.9174,
    "inverseRate": 1.09
  },
  "meta": {
    "standard": "European Central Bank (ECB) Mid-Market Benchmark"
  }
}
GET/api/v1/tip

Tip & Bill Splitter API

Calculates total tip amounts, grand totals, and symmetric per-person bill splits.

Query Parameters
ParameterTypeRequiredDescription
billnumberYesTotal pre-tip bill amount (e.g. 100)
tipnumberNoTip percentage (e.g. 18, default 15)
peoplenumberNoNumber of people splitting (default 1)
Example Request
curl -X GET 'https://quickcalc.cloud/api/v1/tip?bill=100&tip=18&people=4'
Sample JSON Response (200 OK)
{
  "success": true,
  "data": {
    "tipAmount": 18.00,
    "totalBill": 118.00,
    "tipPerPerson": 4.50,
    "totalPerPerson": 29.50,
    "inputs": {
      "billAmount": 100,
      "tipPercentage": 18,
      "peopleCount": 4
    }
  },
  "meta": {
    "formula": "Tip = Bill × (Tip % / 100) | Per Person = (Bill + Tip) / Headcount"
  }
}
Developer Community & Case Studies

Built something cool with our API? Let us know!

Whether you built a mobile app, browser extension, or SaaS integration, we would love to feature your project in our developer showcase and link back to your site.

Submit Your App / Case Study