Docs › API reference › Rates › /api/v1/rates/{date}
GET /api/v1/rates/{date}
Rates for a specific past date, e.g. /api/v1/rates/2026-01-15.
Parameters
date
YYYY-MM-DD, path
Must be a valid calendar date.
base
3-letter code, optional
Defaults to EUR.
symbols
comma-separated codes, optional
Defaults to every currency.
Request
GET /api/v1/rates/2026-01-15Response
{
"base": "EUR",
"date": "2026-01-15",
"rates": { "USD": "1.090000", "GBP": "0.860000" }
}Errors
400 Bad Request
date, base, or symbols failed validation, or referenced a currency the API does not track.
—date must be a valid calendar date in YYYY-MM-DD format
{
"statusCode": 400,
"message": [
"date must be a valid calendar date in YYYY-MM-DD format"
],
"error": "Bad Request"
}—base must be a 3-letter currency code
{
"statusCode": 400,
"message": [
"base must be a 3-letter currency code"
],
"error": "Bad Request"
}—symbols must be a comma-separated list of 3-letter currency codes
{
"statusCode": 400,
"message": [
"symbols must be a comma-separated list of 3-letter currency codes"
],
"error": "Bad Request"
}—Unknown currency: XYZ
{
"statusCode": 400,
"message": "Unknown currency: XYZ",
"error": "Bad Request"
}401 Unauthorized
The Authorization header is missing, malformed, or the key is wrong.
—Missing or malformed Authorization header
{
"statusCode": 401,
"message": "Missing or malformed Authorization header",
"error": "Unauthorized"
}—Invalid API key
{
"statusCode": 401,
"message": "Invalid API key",
"error": "Unauthorized"
}404 Not Found
No rates were ingested for the specific date you asked for.
—No exchange rate data available for 2020-01-01
{
"statusCode": 404,
"message": "No exchange rate data available for 2020-01-01",
"error": "Not Found"
}429 Too Many Requests
Your plan's request quota for the current period is used up.
—Rate limit exceeded: 1000 requests per 30-day period
{
"statusCode": 429,
"message": "Rate limit exceeded: 1000 requests per 30-day period"
}