# Request Status Codes
For all requests, we will return an HTTP status code that indicates a success or the problem that has led to the failure.
A successful request will be returned with status code 200
# API Error Codes
# 401
Invalid authentication credentials
# 403
You are not allowed to use this endpoint, please upgrade your plan (opens new window).
# 404
A requested endpoint does not exist
# 422
Validation error, please check the list of validation errors: here
# 429
You have hit your rate limit or your monthly limit. For more requests please upgrade your plan (opens new window).
# 500
Internal Server Error - let us know: support@freecurrencyapi.com
# Validation errors
# Invalid currencies
One of the selected currencies is invalid, to get a full list of all currencies you can use the currency endpoint.
# Invalid base_currency
The selected base_currency is invalid, to get a full list of all currencies you can use the currency endpoint.
# Invalid date
The date is not a valid date. Please use the following format: YYYY-MM-DD
# Wrong format: value
The value must be a number.
# Chronological order issue: datetime_start
The datetime_start must be a date before or equal to datetime_end
# Invalid datetime_start
The datetime_start is not a valid date.
Datetime for the start of your requested range (format: 2021-12-31T23:59:59Z / ISO8601 Datetime)
# Chronological order issue: datetime_end
The datetime_start must be a date before or equal to datetime_end
# Invalid datetime_end
The datetime_start is not a valid date.
Datetime for the end of your requested range (format: 2021-12-31T23:59:59Z / ISO8601 Datetime)
# Invalid accuracy
The selected accuracy is invalid.
Possible Values: day, hour, quarter_hour, minute Default: day