Instituţiile de credit

Parametri de interogare

Cum se comportă

• Băncile şi sucursalele de bănci străine din România care pot fi identificate din codul de bancă al unui IBAN.
• Nu e registrul BNR integral. Acoperă doar instituţiile care au şi un BIC publicat de GLEIF, din care se obţine codul IBAN — 26 din cele 38 din registru. meta.acoperire spune cifra la fiecare cerere, ca limita să nu fie o presupunere.
• Lista conţine NUMAI instituţii de credit. Registrul de BIC-uri din care pornim are 76 de entităţi româneşti, dintre care 50 nu sunt bănci: o fabrică de bere, Bursa de Valori, case de brokeraj. Ele nu emit IBAN-uri, deci n-au ce căuta într-o listă de bănci.
• Sucursalele băncilor străine (ING, Citibank, Revolut, BNP Paribas) sunt incluse. Ele nu au LEI propriu, ci al societăţii-mamă, deci se confirmă prin potrivire pe denumire cu registrul BNR.
• stare vine din registrul BNR, care o lasă necompletată la o parte din înregistrări. nedeclarata înseamnă „registrul nu spune", nu „inactivă" — de aceea nu există un filtru pe stare: ar pretinde o precizie pe care datele nu o au. meta.stare_nedeclarata spune la câte lipseşte.

La ce folosește

• Popularea unei liste de selecţie a băncilor.
• Verificarea unui cod de bancă înainte de a accepta un IBAN.

Structura răspunsului

Exemple de răspuns

{
    "data": {
        "banci": [
            {
                "cod_iban": "CRCO",
                "denumire": "BANCA CENTRALA COOPERATISTA CREDITCOOP",
                "bic": "CRCOROBUXXX",
                "cui": "361323",
                "lei": "3157006K4C7PJT790450",
                "stare": "activa"
            }
        ]
    },
    "meta": {
        "banci": 21,
        "stare_nedeclarata": 0,
        "sursa": "GLEIF (mapare BIC↔LEI, licenţă CC0) + registrul BNR al instituţiilor de credit.",
        "acoperire": "21 din cele 38 instituţii de credit din registrul BNR au un cod IBAN identificabil.",
        "nota": "Starea vine din registrul BNR, care o lasă necompletată la o parte din înregistrări. `nedeclarata` înseamnă „registrul nu spune\", nu „inactivă\"."
    }
}

Coduri de eroare

Toate erorile au aceeași formă. eroare.cod e stabil și e cel după care trebuie să ramifici în cod — nu după textul din mesaj, care se poate schimba.

{
    "eroare": {
        "cod": "neautentificat",
        "mesaj": "Token lipsă sau invalid."
    }
}