---
title: "Official rate table for a specific date"
method: GET
path: "/api/v1/central-bank/{bank}/{date}"
tags: ["Central Bank Rates"]
---

# Official rate table for a specific date

`GET /api/v1/central-bank/{bank}/{date}`

## Request

- Base URL: `https://allratestoday.com`
- URL: `https://allratestoday.com/api/v1/central-bank/{bank}/{date}`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `art_session`

The bank's published table in force on a date. Weekends and holidays return the most recent published date on or before the requested one — `rate_date` says which, and `published_on_requested_date` is false when they differ (this is the rate compliance users must apply). Optional `source`+`target` narrows to one pair. History reaches back to 2000 and earlier for major sources. Paid plans only. JSON only.

## Path parameters

- `bank` string, required
- `date` string, date, required

## Query parameters

- `source` string
- `target` string

## Response `200`

Table (or single pair) in force on the date

- union
  - CbTableDated
    - `bank` string
    - `name` string
    - `rate_date` string, date
    - `rates` CbRate[]
      - `base` string
      - `quote` string
      - `type` string: Rate type as labeled by the bank (reference, buying, selling, indicative, ...)
      - `value` number, double
    - `disclaimer` string
    - `requested_date` string, date
    - `published_on_requested_date` boolean: False when the bank did not publish on the requested date and the most recent prior table is returned
  - CbPairDated
    - `bank` string
    - `name` string
    - `rate_date` string, date
    - `source` string
    - `target` string
    - `rate` number, double
    - `rate_type` string
    - `derived` boolean: True when not directly published by the bank (inverse or cross-computed)
    - `method` 'published' | 'inverse' | 'cross'
    - `disclaimer` string
    - `requested_date` string, date
    - `published_on_requested_date` boolean

## Other responses

- `400`: Invalid or missing parameters
- `401`: Authentication required — provide an API key via `Authorization: Bearer art_live_...` (free keys at https://allratestoday.com/register)
- `403`: Historical central-bank data requires a paid plan; /latest is available on all plans
- `404`: Unknown bank, no data on/before the date, or pair not covered
- `429`: Monthly request limit exceeded (X-Monthly-Limit / X-Monthly-Used / X-Monthly-Resets headers included)

---

[API](https://skmtc.dev/allratestoday/apis/allratestoday-exchange-rate-central-bank-rates-api.md) · [All operations](https://skmtc.dev/allratestoday/apis/allratestoday-exchange-rate-central-bank-rates-api/llms.txt) · [OpenAPI document](https://skmtc.dev/allratestoday/apis/allratestoday-exchange-rate-central-bank-rates-api/revisions/c2e58e9b4da4?raw)