> ## 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 on a date by rate ID

> Request one historical rate with date=YYYY-MM-DD and check that the date falls within your plan’s retention.

Use `date=YYYY-MM-DD` on a rate's history endpoint. The date must fall within your plan's retention.

```bash curl theme={null}
curl "https://api.cotizave.com/v2/fx/CO/rates/co-trm/history?date=2026-11-03" \
  -H "X-API-Key: $COTIZAVE_API_KEY"
```

Illustrative response; figures and timestamps are samples:

```json theme={null}
{
  "id": "co-trm",
  "market": "co_trm",
  "base": "USD",
  "quote": "COP",
  "date": "2026-11-03",
  "mid": 3900.12,
  "updated_at": "2026-11-03T00:00:00Z",
  "fetched_at": "2026-11-03T12:00:00Z"
}
```

`updated_at` is the source time; `fetched_at` is the capture or response time. A date without an observation can return `404 rate_not_found`. Do not combine `date` with `from`, `to`, or `granularity`.


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