# Publication calendar for a bank

**GET /api/v1/central-bank/{bank}/availability**

The dates a bank actually published a table, for one year (`?year=2026`) or a date range (defaults to the last year; capped at 3700 dates). Weekends, holidays, and weekly/quarterly cadences show up as missing dates. Dates only, no values — available on all plans.


## Servers
- Production: https://allratestoday.com (Production)


## Authentication methods
- Bearer auth
- Session cookie


## Parameters

### Path parameters

- **bank** (string)
  Source code from /api/v1/central-banks (e.g. ecb, boc, cbsl, banxico, ustreasury)


### Query parameters

- **year** (integer)
  Whole calendar year (overrides from/to)

- **from** (string(date))

- **to** (string(date))

- **format** (string)
  Response format (default json). csv is UTF-8 with a BOM; xlsx is a real Excel workbook with typed dates and numbers; xml mirrors the JSON fields.



## Responses
### 200
Ascending list of published dates

#### Body: application/json (object)
- **bank** (string)

- **name** (string)

- **from** (string(date))

- **to** (string(date))

- **count** (integer)

- **truncated** (boolean)

- **dates** (array[string(date)])

- **note_semantics** (string)


### 400
Invalid or missing parameters

#### Body: application/json (object)
- **error** (string)
  Error message

- **hint** (string)
  Optional remediation hint


### 401
Authentication required — provide an API key via `Authorization: Bearer art_live_...` (free keys at https://allratestoday.com/register)

#### Body: application/json (object)
- **error** (string)
  Error message

- **hint** (string)
  Optional remediation hint


### 404
Unknown bank

#### Body: application/json (object)
- **error** (string)
  Error message

- **hint** (string)
  Optional remediation hint


### 429
Monthly request limit exceeded (X-Monthly-Limit / X-Monthly-Used / X-Monthly-Resets headers included)

#### Body: application/json (object)
- **error** (string)

- **used** (integer)

- **limit** (integer)

- **plan** (string)

- **resets_at** (string(date-time))

- **upgrade_url** (string)



[Powered by Bump.sh](https://bump.sh)