Financiar v1 / Banci

O instituţie de credit

Detaliile unei instituţii de credit după codul de bancă din IBAN — cele 4 litere de după cifrele
de control, acelaşi cod_banca întors de /validare/iban. Dacă ai un BIC, primele 4 caractere
sunt codul.

GET

https://oneapi.ro/api/financiar/v1/banci/{cod}

Parametri de cale

NumeTipDescriereExemplu

codobligatoriu string Codul instituţiei de credit din nomenclatorul BNR (ex. CRCO).

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Detaliile unei instituţii de credit după codul de bancă din IBAN — cele 4 litere de după cifrele de control.
E acelaşi cod pe care îl întoarce /validare/iban în cod_banca, deci cele două rute se leagă direct: validezi un IBAN, primeşti codul, ceri detaliile. Dacă ai un BIC, primele 4 caractere sunt codul.
404-ul are două cauze, deosebite prin codul din corp: negasit = codul nu apare în registru; nu_e_institutie_de_credit = codul aparţine unei entităţi care are BIC dar nu e bancă, iar răspunsul spune care, ca ajutor de depanare. A doua situaţie înseamnă aproape sigur un IBAN transcris greşit.

La ce folosește

Afişarea numelui băncii lângă un IBAN, într-un formular de plată.
Validarea unui IBAN dincolo de cifra de control: banca chiar există?
Rutarea unei plăţi sau alegerea canalului potrivit după instituţia emitentă.

Structura răspunsului

CâmpTipDescriere

data.cod_iban string Cele patru litere din poziţiile 5-8 ale IBAN-ului românesc — cheia după care se caută banca.

data.denumire string Denumirea din registrul BNR al instituţiilor de credit.

data.bic string Codul BIC/SWIFT, 11 caractere.

data.cui string Codul fiscal al băncii. null unde registrul nu îl publică.

data.lei string Codul LEI, din GLEIF. null unde banca nu are unul.

data.stare string activa ori radiata, după registrul BNR.

meta.sursa string Sursa oficială din care vin datele, cu licenţa ei acolo unde e cerută.

Exemple de răspuns

GEThttps://oneapi.ro/api/financiar/v1/banci/CRCO

{
    "data": {
        "cod_iban": "CRCO",
        "denumire": "BANCA CENTRALA COOPERATISTA CREDITCOOP",
        "bic": "CRCOROBUXXX",
        "cui": "361323",
        "lei": "3157006K4C7PJT790450",
        "stare": "activa"
    },
    "meta": {
        "sursa": "GLEIF + registrul BNR al instituţiilor de credit."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/banci/WBAN

{
    "data": {
        "cod_iban": "WBAN",
        "denumire": "BANCA COMERCIALA INTESA SANPAOLO ROMANIA SA",
        "bic": "WBANRO22XXX",
        "cui": "8145422",
        "lei": "549300CGLRBLXD8PLZ18",
        "stare": "activa"
    },
    "meta": {
        "sursa": "GLEIF + registrul BNR al instituţiilor de credit."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/banci/RNCB

{
    "data": {
        "cod_iban": "RNCB",
        "denumire": "BANCA COMERCIALA ROMANA S.A.",
        "bic": "RNCBROBUXXX",
        "cui": "361757",
        "lei": "549300ORLU6LN5YD8X90",
        "stare": "activa"
    },
    "meta": {
        "sursa": "GLEIF + registrul BNR al instituţiilor de credit."
    }
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă, invalid, expirat sau revocat.
403	feature_indisponibil	Planul curent nu include funcţia de care ţine ruta.
404	negasit	`negasit` sau `nu_e_institutie_de_credit`.
422	validare	Codul nu are exact 4 litere.
429	cota_depasita	Cota lunară a planului a fost depăşită (vezi `Retry-After`).

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": "validare",
        "mesaj": "Codul nu are exact 4 litere.",
        "detalii": {
            "cod": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}