FinServ API Documentation - Account Search

Account Search API

The Account Search API allows authorized clients to retrieve account details by providing an Account Number.

Endpoint

POST /api/accounts/search

Base URL: https://banking.finserv.com.ng

Authentication

This endpoint requires an API key.

HeaderValue
x-api-keyYour assigned API key

Request

Headers

KeyValue
Content-Typeapplication/json
x-api-keyYOUR_SECURE_API_KEY

Body (JSON)

{
  "accountNumber": "ACCT654321"
}

Response

Success (200 OK)

{
  "accountName": "John Doe",
  "accountNumber": "ACCT654321",
  "accountType": "Savings",
  "dateOpened": "2024-01-15",
  "lastActiveDate": "2026-01-20"
}

Error Responses

Example