UnifyUnits Developers

GET /v1/currency/convert Requires API key

Convert between currencies via query parameters

Identical behaviour to POST /v1/currency/convert, using query parameters instead of a JSON body. Optional `date` uses historical rates and requires the Developer plan or higher.

Prefer a language client when available: JavaScript / TypeScript, Python, or PHP (Laravel). Samples on this page stay raw HTTP so they match the OpenAPI contract.

Parameters

Name Type Required Description
value string Yes Decimal amount as a string (e.g. "100")
from string Yes Currency code, case-insensitive (e.g. "USD")
to string Yes Currency code, case-insensitive (e.g. "GBP")
date string No Historical rate date, YYYY-MM-DD. Requires the Developer plan or higher.
decimals integer No Round the result to this many fractional places (0-40, half-even).
format_locale string No Language tag such as de-DE. Adds a formatted display string (for example 1,5 km) to the result next to the exact value. Requires the Developer plan or higher.

Possible errors

INVALID_REQUEST · INVALID_VALUE · UNKNOWN_CURRENCY · PLAN_REQUIRED · RATE_NOT_FOUND · UNAUTHORIZED · INVALID_API_KEY · RATE_LIMIT_EXCEEDED · QUOTA_EXCEEDED · SERVICE_UNAVAILABLE

All endpoints · Error reference

cURL
curl "https://api.unifyunits.com/v1/currency/convert?value=100&from=USD&to=GBP&decimals=2" \
  -H "Authorization: Bearer $UNIFYUNITS_API_KEY"

Response 200

json
{
  "data": {
    "input": { "value": "100", "unit": "USD" },
    "result": { "value": "64", "unit": "GBP" },
    "rate": { "date": "2026-10-02", "source": "ecb", "value": "0.64" }
  }
}