> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cotizave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Exchange-rate API by country and rate ID

> Query current country rates, one rate by ID, official rates by currency, and historical boards with V2 routes.

Send `X-API-Key` with V2 rate requests. `{CC}` is a two-letter country code; use the `id` returned by the API.

## Official rates by currency

[One response with published official references](https://docs.cotizave.com/en/api/v2/all-rates.md).

## Historical country board

[Country rates for `date=YYYY-MM-DD`](https://docs.cotizave.com/en/api/v2/historical-board).

## Request

[List current country rates and apply filters](https://docs.cotizave.com/en/api/v2/country-rates.md).

## One specific rate

[Get a rate by canonical ID](https://docs.cotizave.com/en/api/v2/rate-detail.md).

## Interpreting a rate

`mid` is the reference value; `updated_at` is the observation time. `stale` tells you whether the freshness threshold passed. `effective_date` is the value date where published. Fields vary by plan: see the [data dictionary](https://docs.cotizave.com/en/api/v2/data-dictionary.md) and [V2 plans](https://docs.cotizave.com/en/api/v2/plans.md).

## Venezuela index

The VE collection may include `index`. Its `as_of` belongs to the index, not to each rate. See the [index methodology](https://docs.cotizave.com/en/cotizave-index.md).

## Next step

See [history](https://docs.cotizave.com/en/api/v2/history.md) or [conversion](https://docs.cotizave.com/en/api/v2/convert.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.