CBR API

About

The CBR API provides access to data from The Central Bank of the Russian Federation. You can retrieve financial organization info and daily currency rates in multiple formats (JSON, XML, HTML).

Available Endpoints

/api/cbr/fin_org/search

Description: Returns an array of financial organizations (VidID = 53) that match a search term by name.

Formats: JSON, XML

GET /api/cbr/fin_org/search?query={query}&output={output}

Parameters:

• query: Search string (name or part of the name)
• output: Desired format (json, xml)

/api/cbr/fin_org/get_full_info

Description: Returns full information about a financial organization by its INN or OGRN.

Formats: HTML, JSON, XML

GET /api/cbr/fin_org/get_full_info?type={type}&data={data}&output={output}

Parameters:

• type: Identifier type (inn or ogrn)
• data: Identifier value
• output: Desired format (html, json, xml)

/api/cbr/currency/get_daily_rates

Description: Provides daily exchange rates from the Central Bank of Russia.

Formats: HTML, JSON, XML

GET /api/cbr/currency/get_daily_rates?date={date}&output={output}

Parameters:

• date: Date (DD/MM/YYYY)
• output: Desired format (html, json, xml)

Usage Example

Example: Get daily rates in JSON format

curl "https://promo-provklad.ru/api/cbr/currency/get_daily_rates?date=13/10/2025&output=json"

Example response:

[
  ...
  {
    "+ID": "R01235",
    "NumCode": "840",
    "CharCode": "USD",
    "Nominal": "1",
    "Name": "Доллар США",
    "Value": "81,1898",
    "VunitRate": "81,1898"
  },
  {
    "+ID": "R01239",
    "NumCode": "978",
    "CharCode": "EUR",
    "Nominal": "1",
    "Name": "Евро",
    "Value": "94,0491",
    "VunitRate": "94,0491"
  },
  ...
]

Example: Search fin org by name (autocomplete`) in JSON format

curl "https://promo-provklad.ru/api/cbr/fin_org/search?query=%D0%A1%D0%B0%D0%BD%D0%BA%D1%82-%D0%9F%D0%B5%D1%82%D0%B5%D1%80%D0%B1%D1%83%D1%80%D0%B3&output=json"

Example response:

[
  {
    "Id": "1315037838403",
    "OGRN": "1027800000140",
    "INN": "7831000027",
    "Name": "ПАО \"Банк \"Санкт-Петербург\"",
    "Status": "Active"
  },
  {
    "Id": "1315037838434",
    "OGRN": "1077800000167",
    "INN": "7835903703",
    "Name": "Санкт-Петербургский банк инвестиций (АО)",
    "Status": "Active"
  }
]

Resources

• 🐳 Docker Hub
• 💻 GitHub