REST v1.1.0

Global & Regional Banks API

High-performance, zero-dependency REST endpoints for retrieving accurate bank routing codes, logos, slugs, and USSD codes globally. Powered by a high-availability infrastructure.

electric_bolt

Getting Started

Our endpoints are built for maximum speed and scale. You can query bank details directly from your web browser, mobile apps, or backend servers. Responses are returned in lightweight JSON format.

// Base API Endpoint URL
https://banks.cybergenii.com/api/v1

verified_user

Zero-Auth

Frictionless integration. No authentication headers or accounts required for public endpoints.

Authorization: None

GET/api/v1/banks

Global Banks Index

Fetches all supported financial institutions globally. Responses are paginated and sortable.

QUERY PARAMETERS

PARAM	TYPE	DEFAULT	DESCRIPTION
page	int	1	Optional. Page offset index.
limit	int	50	Optional. Records per query (max 100).
country	string	-	Optional. Filter by country name or code (e.g. `nigeria`).
search	string	-	Optional. Search term matching bank name, slug, or code.

REQUEST EXAMPLE

curl -X GET "https://banks.cybergenii.com/api/v1/banks?page=1&limit=5"

RESPONSE PAYLOAD
{
  "total": 442,
  "page": 1,
  "limit": 5,
  "pages": 89,
  "data": [
    {
      "name": "Access Bank",
      "slug": "access-bank",
      "code": "044",
      "ussd": "*901#",
      "country": "Nigeria"
    },
    {
      "name": "Citibank",
      "slug": "citibank",
      "code": "023",
      "ussd": null,
      "country": "Nigeria"
    }
  ]
}

GET/api/v1/nig/banks

Country Specific (NIG)

Retrieves the full, unpaginated dataset of all financial institutions in Nigeria. Ideal for client-side local caching.

QUERY PARAMETERS

PARAM	TYPE	DEFAULT	DESCRIPTION
code	string	-	Optional. Filter by exact bank NIP routing code.
slug	string	-	Optional. Filter by exact bank identifier slug.
search	string	-	Optional. Perform text searches.

REQUEST EXAMPLE

curl -X GET "https://banks.cybergenii.com/api/v1/nig/banks"

RESPONSE PAYLOAD
[
  {
    "name": "Guaranty Trust Bank",
    "slug": "guaranty-trust-bank",
    "code": "058",
    "ussd": "*737#",
    "country": "Nigeria"
  },
  {
    "name": "Zenith Bank",
    "slug": "zenith-bank",
    "code": "057",
    "ussd": "*966#",
    "country": "Nigeria"
  }
]

GET/api/v1/nig/banks/[slug]

Single Bank Lookup

Retrieves the complete routing, USSD, and branding metadata for a single bank matching the path slug parameter.

PATH VARIABLES

VARIABLE	TYPE	STATUS	DESCRIPTION
slug	string	Required	The unique bank slug (e.g. `access-bank`).

REQUEST EXAMPLE

curl -X GET "https://banks.cybergenii.com/api/v1/nig/banks/access-bank"

RESPONSE PAYLOAD
{
  "name": "Access Bank",
  "slug": "access-bank",
  "code": "044",
  "ussd": "*901#",
  "country": "Nigeria"
}

GET/api/v1/nig/banks/[slug]/logo

Bank Logo CDN

Serves PNG/SVG branding logos directly with immutable cache-control headers, enabling high-performance rendering in your UI templates.

PATH VARIABLES

VARIABLE	TYPE	STATUS	DESCRIPTION
slug	string	Required	Unique slug key for the bank logo.

COVERED BRANDING LOGOS

Access

GTBank

Zenith

UBA

REQUEST EXAMPLE

curl -I "https://banks.cybergenii.com/api/v1/nig/banks/access-bank/logo"

RESPONSE HEADERS
HTTP/1.1 200 OK
Content-Type: image/png
Cache-Control: public, max-age=31536000, immutable
Access-Control-Allow-Origin: *