Unit Conversion API

GET /api/convert

Convert a value between two units.

Query Parameters:

• fromUnit (required) — Source unit slug (e.g., meter, kilogram)
• toUnit (required) — Target unit slug (e.g., foot, pound)
• value (required) — Number to convert (e.g., 100)

Example Request:

GET /api/convert?fromUnit=meter&toUnit=foot&value=100

Example Response:

{
  "fromUnit": "meter",
  "toUnit": "foot",
  "value": 100,
  "result": 328.084,
  "formula": "100 m × 3.28084 = 328.084 ft"
}

GET /api/categories

List all conversion categories.

Example Response:

{
  "categories": [
    { "id": 1, "slug": "length", "name": "Length", "icon": "ruler" },
    { "id": 2, "slug": "weight", "name": "Weight", "icon": "weight" },
    ...
  ]
}

GET /api/categories/:slug/units

List all units in a specific category.

Path Parameters:

• slug — Category slug (e.g., length, temperature)

Example Response:

{
  "category": "length",
  "units": [
    { "id": 1, "slug": "meter", "name": "Meter", "symbol": "m", "factor": 1 },
    { "id": 2, "slug": "foot", "name": "Foot", "symbol": "ft", "factor": 0.3048 },
    ...
  ]
}

Free Tier (Public API)

• 100 requests per 15 minutes per IP address
• Health check endpoint (/health) is not rate limited
• Rate limit headers included in all responses