🔌 Konvertibly API Documentation

Free RESTful API for integrating Konvertibly into your applications

Register Now - It's Free!

✓ Unlimited API requests    ✓ Usage analytics dashboard    ✓ Email support

Getting Started

The Konvertibly API provides free access to our comprehensive conversion tools. Authentication is optional but recommended for tracking usage and accessing premium features. Perfect for AI assistants, chatbots, web applications, and mobile apps.

Base URL

https://konvertibly.com/api

Authentication (Optional)

Include your API key in requests using either the X-API-Key header or api_key query parameter. Get your free API key →

Method 1: Using Header (Recommended)

fetch('https://konvertibly.com/api/currency/convert', { method: 'POST', headers: { 'Content-Type': 'application/json', 'X-API-Key': 'kv_your_api_key_here' }, body: JSON.stringify({ from: 'USD', to: 'EUR', amount: 100 }) })

Method 2: Using Query Parameter

https://konvertibly.com/api/currency/convert?api_key=kv_your_api_key_here

API Key Format: kv_[64 hexadecimal characters] (67 characters total)

Response Format

All API responses are in JSON format with the following structure:

{ "success": true, "data": { ... }, "timestamp": "2025-01-15T10:30:00Z" }

Rate Limits

Without API Key: Best-effort rate limiting
With Free API Key: Unlimited requests with fair usage policy
Premium Tiers: Coming soon with guaranteed SLA and priority support

Currency Conversion

POST /api/currency/convert

Convert between 210 currencies (183 traditional + 27 cryptocurrencies) with live exchange rates.

Request Parameters

Parameter Type Required Description
from string Yes Source currency code (e.g., USD, EUR, BTC)
to string Yes Target currency code
amount number Yes Amount to convert

Example Request

// With API Key (Recommended) fetch('https://konvertibly.com/api/currency/convert', { method: 'POST', headers: { 'Content-Type': 'application/json', 'X-API-Key': 'kv_your_api_key_here' }, body: JSON.stringify({ from: 'USD', to: 'EUR', amount: 100 }) }) .then(res => res.json()) .then(data => console.log(data)); // Without API Key (Anonymous) fetch('https://konvertibly.com/api/currency/convert', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ from: 'USD', to: 'EUR', amount: 100 }) }) .then(res => res.json()) .then(data => console.log(data));

Example Response

{ "success": true, "from": "USD", "to": "EUR", "amount": 100, "result": 92.15, "rate": 0.9215, "lastUpdated": "2025-01-15T10:30:00Z" }

Unit Conversion

POST /api/unit/convert

Convert between various units including length, weight, temperature, volume, area, and more.

Request Parameters

Parameter Type Required Description
category string Yes Unit category (length, weight, temperature, etc.)
from string Yes Source unit (e.g., feet, celsius)
to string Yes Target unit (e.g., meters, fahrenheit)
value number Yes Value to convert

Example Request

// With API Key (Recommended) fetch('https://konvertibly.com/api/unit/convert', { method: 'POST', headers: { 'Content-Type': 'application/json', 'X-API-Key': 'kv_your_api_key_here' }, body: JSON.stringify({ category: 'length', from: 'feet', to: 'meters', value: 100 }) }) .then(res => res.json()) .then(data => console.log(data));

Example Response

{ "success": true, "category": "length", "from": "feet", "to": "meters", "value": 100, "result": 30.48, "formula": "feet × 0.3048" }

Color Conversion

POST /api/color/convert

Convert between color formats: HEX, RGB, HSL, CMYK, and more.

Example Request

fetch('https://konvertibly.com/api/color/convert', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ from: 'hex', to: 'rgb', value: '#667eea' }) }) .then(res => res.json()) .then(data => console.log(data));

Example Response

{ "success": true, "from": "hex", "to": "rgb", "value": "#667eea", "result": { "r": 102, "g": 126, "b": 234 } }

Health Calculators

POST /api/health/bmi

Calculate BMI (Body Mass Index) and other health metrics.

Example Request

fetch('https://konvertibly.com/api/health/bmi', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ weight: 70, weightUnit: 'kg', height: 175, heightUnit: 'cm' }) }) .then(res => res.json()) .then(data => console.log(data));

Example Response

{ "success": true, "bmi": 22.86, "category": "Normal weight", "healthyRange": "18.5 - 24.9", "recommendation": "Your BMI is in the healthy range." }

Rate Limits & Best Practices

Rate Limits

• Free tier: 100 requests per 15 minutes per IP
• No authentication required for basic usage
• Contact us for higher limits or commercial usage

Best Practices

• Cache API responses when possible
• Use appropriate HTTP methods (POST for conversions)
• Handle errors gracefully
• Include proper error handling for network failures

Error Handling

{ "success": false, "error": "Invalid currency code", "message": "Currency 'XYZ' is not supported", "timestamp": "2025-01-15T10:30:00Z" }

All Available Endpoints

Konvertibly provides 200+ API endpoints across 30 conversion categories:

  • Currency: /api/currency/* - 210 currencies
  • Units: /api/unit/* - Length, weight, temperature, volume, etc.
  • Colors: /api/color/* - HEX, RGB, HSL, CMYK conversions
  • Health: /api/health/* - BMI, body fat, calorie calculators
  • Cooking: /api/cooking/* - Recipe scaling, ingredient conversions
  • Finance: /api/finance/* - Interest, loans, taxes
  • Digital: /api/digital/* - Data storage, transfer rates
  • Time & Date: /api/timezone/* - Timezone conversions
  • Science: /api/science/* - Chemistry, physics calculations
  • Engineering: /api/engineering/* - Pressure, torque, stress
  • And 20+ more categories...

Support & Resources

Need help or have questions about the API?

• Contact Us - Get in touch with our support team
• API Status - Check system health and uptime
• Getting Started Guide - Learn how to integrate our API

Back to Home