Banks List

Returns the complete list of Nigerian banks with their codes NIBSS/NIP for use in account verification.

Endpoint

GET /kyc/nga/banks

Authentication

Type	Location	Name
API Key	Header	x-api-key

Responses

200 Success

Response parameters

Parameter	Type	Description
serviceResultCode	integer	Code that indicates the overall result of the service execution. See Service Result Code
serviceTime	string	Processing time (milliseconds).
serviceResultLog	string	Descriptive field for the result of the service execution. Includes details when there is an error or exception in the module.
serviceTransactionId	string	Transaction identifier associated with the request processed by the API.
data	object	Object with the list of banks. See table below.

Response parameters — data

Parameter	Type	Description
banks	array	List of Nigerian banks. See table below.
totalBanks	integer	Total number of banks in the list.

Response parameters — data.banks[]

Parameter	Type	Description
bankCode	string	Bank code.
bankName	string	Bank name.
nipCode	string	Bank's NIP code.

Service Result Code

The serviceResultCode indicates the overall result of the service execution:

serviceResultCode	Description	HTTP code
200	The service execution was successful, the module processed the request correctly.	200

Response example

{
  "serviceResultCode": 200,
  "serviceTime": "500",
  "serviceResultLog": "Success",
  "serviceTransactionId": "e41h235i-34i2-1h3l-h86h-2i681hj22jk",
  "data": {
    "banks": [
      {
        "bankCode": "044",
        "bankName": "Access Bank",
        "nipCode": "044"
      },
      {
        "bankCode": "063",
        "bankName": "Access Bank (Diamond)",
        "nipCode": "063"
      },
      {
        "bankCode": "023",
        "bankName": "Citibank Nigeria",
        "nipCode": "023"
      },
      {
        "bankCode": "050",
        "bankName": "Ecobank Nigeria",
        "nipCode": "050"
      },
      {
        "bankCode": "011",
        "bankName": "First Bank of Nigeria",
        "nipCode": "011"
      },
      {
        "bankCode": "058",
        "bankName": "Guaranty Trust Bank",
        "nipCode": "058"
      },
      {
        "bankCode": "033",
        "bankName": "United Bank For Africa",
        "nipCode": "033"
      },
      {
        "bankCode": "057",
        "bankName": "Zenith Bank",
        "nipCode": "057"
      }
    ],
    "totalBanks": 22
  }
}

400 Bad Request

Error returned with the service envelope (serviceResultCode reflects the HTTP response code):

{
  "serviceResultCode": 400,
  "serviceResultLog": "Sorry, lookup failed. Please check the details and try again",
  "serviceTime": "151",
  "serviceTransactionId": "08ac9699-dc9e-4cdc-81d7-264f71838309"
}

502 Bad Gateway

Returned when the service is temporarily unavailable or its response could not be interpreted. The body uses the service envelope with serviceResultCode: 500:

{
  "serviceResultCode": 500,
  "serviceResultLog": "Service temporarily unavailable. Please try again later",
  "serviceTime": "3000",
  "serviceTransactionId": "38de2932-0f2h-7gff-14g0-597h04161632"
}

504 Gateway Timeout

Timeout error, returned with the service envelope:

{
  "serviceResultCode": 504,
  "serviceResultLog": "Request timeout. Please try again",
  "serviceTime": "30000",
  "serviceTransactionId": "48ef3043-1g3i-8hgg-25h1-608i15272743"
}

Authentication errors (401/403) are rejected by the gateway before reaching the service and do not use the envelope serviceResultCode. Platform validation errors use the format application/problem+json. See Error handling for details on the three response forms.