Bank Codes - Nuvion

This endpoint returns the directory of banks and their routing information for a given country.

Get bank codes

GET /bank-codes/{country}

Directory data is currently available for NG, HK, CN, TZ, CA, GH, KE, UG and ZA. Other countries return an empty data array. For those corridors, obtain routing identifiers from the account holder.

Request parameters

string

required

ISO 3166-1 alpha-2 country code. e.g. NG, GH, KE.

Request

curl -X GET https://api.nuvion.dev/bank-codes/NG \
  -H "Authorization: Bearer $NUVION_API_KEY"

Response

Returns the list of banks for the requested country.

string

success or error.

string

Human-readable summary of the result.

array

The list of banks for the requested country. Empty if the country has no directory data.

Show data fields

string

The bank’s routing code, where applicable. Format varies by country.

string

Name of the bank.

string

The bank’s SWIFT/BIC code, where applicable.

string

Institution number for the bank, where applicable.

{
    "status": "success",
    "message": "Bank codes retrieved successfully",
    "data": [
        {
            "bank_code": "120001",
            "bank_name": "9 Payment Service Bank",
            "swift_bic": "IPSBNGLA"
        },
        {
            "bank_code": "090270",
            "bank_name": "AB Microfinance Bank",
            "swift_bic": null
        },
        {
            "bank_code": "090260",
            "bank_name": "Above Only Microfinance Bank",
            "swift_bic": null
        }
    ]
}

{
    "status": "success",
    "message": "Bank codes retrieved successfully",
    "data": [
        {
            "bank_name": "Central 1 Credit Union of Alberta",
            "swift_bic": "CUCXCATTCAL",
            "bank_institution_number": "899"
        }
    ]
}

Errors

Code	Description
`422`	`country` isn’t a valid 2-character ISO code.

See Errors for the standard error object schema.

400-500

{
  "status": "error",
  "message": "Validation failed for one or more fields",
  "type": "error_validation_error",
  "validations": [
    {
      "country": {
        "type": "error_validation_invalid_length",
        "message": "The 'country' field must be no more than 2 characters long. Please update it and try again."
      }
    }
  ]
}

​Get bank codes

​Request parameters

​Request

​Response

​Errors

Get bank codes

Request parameters

Request

Response

Errors