BizKitHub
DocsAPI ReferenceCurrency/bff/currency/rate-sheet
getCurrencyAdmin BFF

/bff/currency/rate-sheet

Daily rate sheet re-expressed in the organisation default currency. Combines fixings from CNB, ECB, and Fawaz Ahmed Currency API; pairs without a direct quote are resolved via cross-rate paths through pivot currencies (CZK / EUR / USD). Each rate says how many units of the base currency one unit of code is worth.

CurrencygetBffCurrencyRate-sheet

Parameters

1 query

Query parameters

· 1
datestringOptional

Target date in YYYY-MM-DD. Defaults to today. The actual fixing returned (fixingDate) may be earlier when the requested date is a weekend, holiday, or before the daily CNB publication.

Example2026-04-27

Response schema

1 status code documented

200Success
baseCodestringRequired

Base (org default) currency code.

ExampleEUR
baseNamestring | nullRequired
One of 2:
Variant 1
string
ExampleEuro
Variant 2
null
baseSymbolstringRequired
Example€
fixingDatestringRequired

Latest fixing date represented in the sheet.

Example2026-04-27
itemsobject[]Required
Each array item:
codestringRequired
ExampleUSD
namestring | nullRequired
One of 2:
Variant 1
string
ExampleUS Dollar
Variant 2
null
symbolstringRequired
Example$
decimalsnumberRequired
Example2
ratenumberRequired

How many units of the base currency 1 unit of code is worth on the fixing date.

Example0.85
hopsnumberRequired

Number of pivot currencies traversed to reach code (0 = direct quote, 1+ = via cross-rate path).

Examples012
rateDatestringRequired

YYYY-MM-DD of the oldest fixing in the resolution path (the rate is only as fresh as this).

Example2026-04-27
itemCountnumberRequired
Example120

Response example

application/json
{
  "baseCode": "EUR",
  "baseSymbol": "€",
  "fixingDate": "2026-04-27",
  "items": [
    {
      "code": "USD",
      "symbol": "$",
      "decimals": 2,
      "rate": 0.85,
      "hops": 0,
      "rateDate": "2026-04-27"
    }
  ],
  "itemCount": 120
}

Request example

GET /bff/currency/rate-sheet

get
curl -X GET "https://api.bizkithub.com/bff/currency/rate-sheet?date=2026-04-27" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key