> ## 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 rates by country: V2 API

> Request GET /v2/fx/{CC}/rates, filter by category, and read each returned rate’s ID, currency, and availability.

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

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

Optional filters: `tag`, `category`, `base`, and `quote`. Filters intersect. Your plan may show price-free descriptors for restricted rates.


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