Calculator API

Authentication

All API requests require an API key sent via the X-API-Key header. Get your API key from the dashboard.

curl -X POST https://www.digicalcs.com/api/v1/calculate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"calculator": "percentage", "inputs": {"value": 200, "percentage": 15}}'

Calculate Endpoint

Request body

{
  "calculator": "compound-interest",
  "inputs": {
    "principal": 1000,
    "rate": 5,
    "years": 10,
    "compounding": "annually"
  }
}

Response

{
  "success": true,
  "calculator": "compound-interest",
  "inputs": { ... },
  "message": "Inputs validated for compound-interest calculator",
  "calculatorUrl": "https://www.digicalcs.com/en/finance/interest/compound-interest",
  "timestamp": "2026-05-14T10:30:00.000Z"
}

Code Examples

JavaScript (fetch)

const response = await fetch('https://www.digicalcs.com/api/v1/calculate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
    calculator: 'bmi',
    inputs: { weight: 70, height: 175, unit: 'metric' },
  }),
});
const data = await response.json();
console.log(data);

Python (requests)

import requests

response = requests.post(
    'https://www.digicalcs.com/api/v1/calculate',
    headers={'X-API-Key': 'YOUR_API_KEY'},
    json={
        'calculator': 'bmi',
        'inputs': {'weight': 70, 'height': 175, 'unit': 'metric'}
    }
)
print(response.json())

Rate Limits

Error Codes