OFFICIAL DEVELOPER DOCUMENTATION v1.0

UpraiserTech Data Platform API Reference

Developer-first APIs for Countries, 774 LGAs, Banks, Higher Education, Currencies & Telecoms.

INDEX
1. GETTING STARTED

Quick Start Guide

All UpraiserTech REST API endpoints return data formatted in a standard JSON envelope. All request parameters are passed as URL query parameters or JSON body payloads.

Base Production API URL:
https://upraisertech.name.ng/api/v1
Example cURL Request:
curl -X GET "https://upraisertech.name.ng/api/v1/banks?country=NG&limit=10" \
  -H "X-API-Key: ut_live_98a76f5e4d3c2b1a0f9e8d7c"
2. SECURITY & AUTH

API Authentication

Authenticate your API calls by including your API key in the request headers. Generate and manage API keys inside your Developer Dashboard.

Supported Authentication Headers:
X-API-Key: ut_live_xxxxxx
Authorization: Bearer ut_live_xxxxxx
3. DATA CONTRACT

Standard Response Envelope Format

Every API response follows a standard JSON envelope to simplify parsing across frontend apps and microservices:

{
  "success": true,
  "message": "Banks fetched successfully",
  "data": [
    {
      "id": "bnk_access",
      "name": "Access Bank",
      "code": "044",
      "cbnCode": "044",
      "slug": "access-bank",
      "type": "COMMERCIAL",
      "isFintech": false
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "totalPages": 8
  },
  "metadata": {
    "timestamp": "2026-08-05T09:28:31.000Z",
    "version": "v1",
    "docs": "https://upraisertech.name.ng/docs"
  }
}
4. SLA & QUOTAS

Rate Limits & Quotas

Free tier accounts receive up to 1,000 requests per hour. All response headers include active quota details:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 984
X-RateLimit-Reset: 1785532800
5. ERRORS & STATUS CODES

Error Handling & Codes

Errors return standard HTTP status codes along with descriptive error envelopes:

400 Bad Request

Missing or invalid request parameters.

401 Unauthorized

Missing or invalid X-API-Key header.

429 Rate Limit Exceeded

Exceeded 1,000 requests/hour quota.

500 Internal Server Error

Server error processing request.

6. GEOLOCATION API

Countries, States & 774 LGAs Endpoints

GET/api/v1/countries

Retrieve 240+ countries with ISO2, ISO3, capitals, population & phone codes.

GET/api/v1/countries/NG/states

Fetch all 36 Nigerian states + FCT Abuja with capitals, LGA counts & geopolitical zones.

GET/api/v1/lgas?state=Lagos

Query all 774 Nigerian Local Government Areas (LGAs) with state filters and search.

7. FINANCIAL DATA

Banks & Fintech API

GET/api/v1/banks?country=NG&fintech=true

Access 150+ commercial banks, non-interest banks, and digital MFBs (Kuda, OPay, PalmPay, Moniepoint, PiggyVest) with CBN routing codes.

8. HIGHER EDUCATION

Universities & Schools API

GET/api/v1/universities?category=UNIVERSITY&ownership=FEDERAL

Query Federal, State, and Private Universities, Polytechnics, and Colleges of Education across Nigeria and West Africa.

9. HIGHER EDUCATION FACULTIES

Higher Education Faculties API

GET/api/v1/faculties?category=STEM

Access 13 core academic faculties (Sciences, Engineering, Medicine, Pharmacy, Law, Education, Social Sciences, Management, Environmental, Agriculture, etc.).

10. ACADEMIC DEPARTMENTS

Academic Departments API

GET/api/v1/departments?category=STEM&search=Computer

Access 133 standard academic departments with faculty classifications, department codes, and degree offerings (B.Sc., M.Sc., Ph.D.).

10. CURRENCIES & DIGITAL ASSETS

Currencies & FX API

GET/api/v1/currencies?search=NGN

Access 50+ African fiat currencies, global fiat currencies, and major digital assets / stablecoins (BTC, ETH, USDT, USDC).

10. SDKs & SCHEMA EXPORTS

OpenAPI Spec & Postman Collection

Import our OpenAPI v3.0 schema directly into Postman, Insomnia, or generate client SDK libraries for JavaScript, Python, PHP, Go, and Flutter.