> ## 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.

# Get started with the V2 exchange-rate API

> Create an API key, request GET /v2/fx/{CC}/rates, and learn how to read V2 rate IDs, dates, errors, and availability.

V2 uses rate IDs such as `co-trm` and routes under `https://api.cotizave.com/v2/`. Create an API key in the [dashboard](https://app.cotizave.com) and send it from your server.

## First request

```bash curl theme={null}
curl "https://api.cotizave.com/v2/fx/CO/rates" \
  -H "X-API-Key: $COTIZAVE_API_KEY"
```

Illustrative response; values are not current quotes:

```json theme={null}
{
  "country": "CO",
  "currency": "COP",
  "base": "USD",
  "fetched_at": "2026-11-03T12:00:00Z",
  "plan": "free",
  "rates": [
    { "id": "co-trm", "market": "co_trm", "type": "reference", "mid": 3900.12, "updated_at": "2026-11-03T00:00:00Z" }
  ]
}
```

Use the returned `id` to query a rate, its history, or a conversion. Available fields depend on your plan.

## Next steps

* [Rates by country and ID](https://docs.cotizave.com/en/api/v2/rates.md)
* [History, statistics, and moving averages](https://docs.cotizave.com/en/api/v2/history.md)
* [Single and bulk conversion](https://docs.cotizave.com/en/api/v2/convert.md)
* [All V2 routes](https://docs.cotizave.com/en/api/v2/endpoints.md)
* [Plans and fields](https://docs.cotizave.com/en/api/v2/plans.md)
* [Authentication, formats, and errors](https://docs.cotizave.com/en/api/authentication.md)

If you use a coding agent, see the [Cotizave skill](https://docs.cotizave.com/en/agent-skill.md). For migration from Venezuela V1, see [V1 → V2](https://docs.cotizave.com/en/api/v2/migration.md).


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