📚 API Documentation
Complete guide to integrate Converter Bundle APIs
🚀
Getting Started
Quick setup guide
🔐
Authentication
API key setup
🔌
API Endpoints
All available APIs
💻
Code Examples
Integration samples
🚀 Getting Started
Overview
The Converter Bundle API provides programmatic access to all conversion tools including currency exchange, timezone conversions, unit conversions, and JSON utilities.
⚡
Fast & Reliable
99.9% uptime SLA
🌍
Global CDN
Low latency worldwide
🔒
Secure
HTTPS & API key auth
📊
Rate Limits
Generous free tier
Base URL
https://api.converter-bundle.com/v1
Rate Limits
| Plan | Requests/Hour | Requests/Day | Requests/Month |
|---|---|---|---|
| Free | 100 | 1,000 | 10,000 |
| Basic | 500 | 10,000 | 100,000 |
| Pro | 2,000 | 50,000 | 1,000,000 |
| Enterprise | Unlimited (Custom) | ||
🔐 Authentication
API Key Authentication
All API requests require authentication using your API key. Include your API key in the request header:
Authorization: Bearer YOUR_API_KEY
Get Your API Key
- Go to API Keys Management
- Sign up or log in to your account
- Generate a new API key
- Copy your API key (keep it secure!)
⚠️ Security Warning
Never expose your API key in client-side code or public repositories. Always use environment variables or secure key management systems.
Example Request
curl -X GET "https://api.converter-bundle.com/v1/currency/convert?from=USD&to=EUR&amount=100" \ -H "Authorization: Bearer YOUR_API_KEY"
🔌 API Endpoints
💱 Currency Conversion
GET
/currency/convert
Convert currency from one to another
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| from | string | Required | Source currency code (e.g., USD) |
| to | string | Required | Target currency code (e.g., EUR) |
| amount | number | Required | Amount to convert |
Response
{
"success": true,
"from": "USD",
"to": "EUR",
"amount": 100,
"result": 92.00,
"rate": 0.92,
"timestamp": "2026-01-19T14:05:00Z"
}
⚙️ Unit Conversion
GET
/units/convert
Convert between different units of measurement
Supports: length, weight, temperature, volume, area, speed, pressure, power, energy, torque
🕐 Timezone & 📄 JSON Tools
Additional endpoints for timezone conversion, JSON validation, formatting, and more...
💻 Code Examples
JavaScript / Node.js
// Install: npm install axios
const axios = require('axios');
const API_KEY = process.env.CONVERTER_API_KEY;
const BASE_URL = 'https://api.converter-bundle.com/v1';
async function convertCurrency(from, to, amount) {
try {
const response = await axios.get(`${BASE_URL}/currency/convert`, {
params: { from, to, amount },
headers: {
'Authorization': `Bearer ${API_KEY}`
}
});
return response.data;
} catch (error) {
console.error('Error:', error.response.data);
}
}
// Usage
convertCurrency('USD', 'EUR', 100)
.then(data => console.log(data));
Python
# Install: pip install requests
import os
import requests
API_KEY = os.getenv('CONVERTER_API_KEY')
BASE_URL = 'https://api.converter-bundle.com/v1'
def convert_currency(from_currency, to_currency, amount):
url = f'{BASE_URL}/currency/convert'
headers = {
'Authorization': f'Bearer {API_KEY}'
}
params = {
'from': from_currency,
'to': to_currency,
'amount': amount
}
response = requests.get(url, headers=headers, params=params)
if response.status_code == 200:
return response.json()
else:
raise Exception(f'Error: {response.status_code}')
# Usage
result = convert_currency('USD', 'EUR', 100)
print(result)
⚠️ Error Handling
HTTP Status Codes
| Status Code | Meaning | Description |
|---|---|---|
| 200 | OK | Request successful |
| 400 | Bad Request | Invalid parameters |
| 401 | Unauthorized | Invalid or missing API key |
| 429 | Too Many Requests | Rate limit exceeded |
| 500 | Internal Server Error | Server error |
Error Response Format
{
"success": false,
"error": {
"code": "INVALID_CURRENCY",
"message": "Currency code 'XYZ' is not supported",
"details": {
"supported_currencies": ["USD", "EUR", "GBP", "..."]
}
}
}