NBRB API v1.0.0

Scroll down for code samples, example requests and responses. Select a language for code samples from the tabs above or the mobile navigation menu.

NBRB API.

Base URLs:

• https://api.nbrb.by/

• https://sandbox.nbrb.by/

Public

GET /banks

Code samples

# You can also use wget
curl -X GET https://api.nbrb.by/banks \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Version: 1.0.0' \
  -H 'Accept: application/json'

GET https://api.nbrb.by/banks HTTP/1.1
Host: api.nbrb.by

Accept: application/json
Accept: application/json
Content-Type: application/json
X-Api-Version: 1.0.0

var headers = {
  'Accept':'application/json',
  'Content-Type':'application/json',
  'X-Api-Version':'1.0.0',
  'Accept':'application/json'

};

$.ajax({
  url: 'https://api.nbrb.by/banks',
  method: 'get',

  headers: headers,
  success: function(data) {
    console.log(JSON.stringify(data));
  }
})

const request = require('node-fetch');

const headers = {
  'Accept':'application/json',
  'Content-Type':'application/json',
  'X-Api-Version':'1.0.0',
  'Accept':'application/json'

};

fetch('https://api.nbrb.by/banks',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Accept' => 'application/json',
  'Content-Type' => 'application/json',
  'X-Api-Version' => '1.0.0',
  'Accept' => 'application/json'
}

result = RestClient.get 'https://api.nbrb.by/banks',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Accept': 'application/json',
  'Content-Type': 'application/json',
  'X-Api-Version': '1.0.0',
  'Accept': 'application/json'
}

r = requests.get('https://api.nbrb.by/banks', params={

}, headers = headers)

print r.json()

URL obj = new URL("https://api.nbrb.by/banks");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

Banks

Bank.

Parameters

Enumerated Values

Example responses

{
  "items": [
    {
      "type": "Bank",
      "handle": "nbrb",
      "name": "NBRB",
      "full_name": "National Bank of the Republic of Belarus",
      "bic": "IRJSBY22",
      "unp": "string",
      "okpo": "string",
      "swift": "NBRB BY2X",
      "address": {
        "country": "BY",
        "state": "Minsk",
        "city": "Minsk",
        "line": "praspiekt Niezaliežnasci, 20",
        "postcode": "220008"
      },
      "phone": "+375173060002",
      "fax": "+375173274879",
      "telex": "252449 BELAR BY",
      "email": "info@nbrb.by",
      "website": "https://nbrb.by/",
      "presedent": "string",
      "registration_number": "1",
      "registration_date": "1991-01-01"
    }
  ]
}

{
  "code": "string",
  "message": "string",
  "fields": "string"
}

{
  "code": "string",
  "message": "string",
  "fields": "string"
}

{
  "code": "string",
  "message": "string",
  "fields": "string"
}

Responses

GET /currencies

Code samples

# You can also use wget
curl -X GET https://api.nbrb.by/currencies \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Version: 1.0.0' \
  -H 'Accept: application/json'

GET https://api.nbrb.by/currencies HTTP/1.1
Host: api.nbrb.by

Accept: application/json
Accept: application/json
Content-Type: application/json
X-Api-Version: 1.0.0

var headers = {
  'Accept':'application/json',
  'Content-Type':'application/json',
  'X-Api-Version':'1.0.0',
  'Accept':'application/json'

};

$.ajax({
  url: 'https://api.nbrb.by/currencies',
  method: 'get',

  headers: headers,
  success: function(data) {
    console.log(JSON.stringify(data));
  }
})

const request = require('node-fetch');

const headers = {
  'Accept':'application/json',
  'Content-Type':'application/json',
  'X-Api-Version':'1.0.0',
  'Accept':'application/json'

};

fetch('https://api.nbrb.by/currencies',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Accept' => 'application/json',
  'Content-Type' => 'application/json',
  'X-Api-Version' => '1.0.0',
  'Accept' => 'application/json'
}

result = RestClient.get 'https://api.nbrb.by/currencies',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Accept': 'application/json',
  'Content-Type': 'application/json',
  'X-Api-Version': '1.0.0',
  'Accept': 'application/json'
}

r = requests.get('https://api.nbrb.by/currencies', params={

}, headers = headers)

print r.json()

URL obj = new URL("https://api.nbrb.by/currencies");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

Currencies

Currencies.

Parameters

Enumerated Values

Example responses

{
  "items": [
    {
      "type": "CurrencyRate",
      "currency_from": "EUR",
      "currency_from_name": "Euro",
      "currency_to": "BYN",
      "currency_to_name": "Belarusian ruble",
      "exchange_rate": "2.3676"
    }
  ]
}

{
  "code": "string",
  "message": "string",
  "fields": "string"
}

{
  "code": "string",
  "message": "string",
  "fields": "string"
}

{
  "code": "string",
  "message": "string",
  "fields": "string"
}

Responses

Schemas

PostalAddress

{
  "country": "BY",
  "state": "Minsk",
  "city": "Minsk",
  "line": "praspiekt Niezaliežnasci, 20",
  "postcode": "220008"
} 

Properties

Bank

{
  "type": "Bank",
  "handle": "nbrb",
  "name": "NBRB",
  "full_name": "National Bank of the Republic of Belarus",
  "bic": "IRJSBY22",
  "unp": "string",
  "okpo": "string",
  "swift": "NBRB BY2X",
  "address": {
    "country": "BY",
    "state": "Minsk",
    "city": "Minsk",
    "line": "praspiekt Niezaliežnasci, 20",
    "postcode": "220008"
  },
  "phone": "+375173060002",
  "fax": "+375173274879",
  "telex": "252449 BELAR BY",
  "email": "info@nbrb.by",
  "website": "https://nbrb.by/",
  "presedent": "string",
  "registration_number": "1",
  "registration_date": "1991-01-01"
} 

Properties

BankList

{
  "items": [
    {
      "type": "Bank",
      "handle": "nbrb",
      "name": "NBRB",
      "full_name": "National Bank of the Republic of Belarus",
      "bic": "IRJSBY22",
      "unp": "string",
      "okpo": "string",
      "swift": "NBRB BY2X",
      "address": {
        "country": "BY",
        "state": "Minsk",
        "city": "Minsk",
        "line": "praspiekt Niezaliežnasci, 20",
        "postcode": "220008"
      },
      "phone": "+375173060002",
      "fax": "+375173274879",
      "telex": "252449 BELAR BY",
      "email": "info@nbrb.by",
      "website": "https://nbrb.by/",
      "presedent": "string",
      "registration_number": "1",
      "registration_date": "1991-01-01"
    }
  ]
} 

Properties

CurrencyRate

{
  "type": "CurrencyRate",
  "currency_from": "EUR",
  "currency_from_name": "Euro",
  "currency_to": "BYN",
  "currency_to_name": "Belarusian ruble",
  "exchange_rate": "2.3676"
} 

Properties

CurrencyRateList

{
  "items": [
    {
      "type": "CurrencyRate",
      "currency_from": "EUR",
      "currency_from_name": "Euro",
      "currency_to": "BYN",
      "currency_to_name": "Belarusian ruble",
      "exchange_rate": "2.3676"
    }
  ]
} 

Properties

Error

{
  "code": "string",
  "message": "string",
  "fields": "string"
} 

Properties