Data Sources Microservice API (1.0.0)

Download OpenAPI specification:

License: MIT

API for NIGSAC search functionality and supporting data services. The main feature is the advanced fuzzy search capability for individuals, entities, and ID numbers in the NIGSAC database.

API Documentation

Returns the API documentation page

Responses

Health Check

Returns the health status of the API

Responses

Response samples

Content type
application/json
{
  • "status": "healthy"
}

Login with Email and Password

Authenticate using email and password to get a JWT token

Request Body schema: application/json
required
email
required
string <email>
password
required
string

Responses

Request samples

Content type
application/json
{
  • "email": "user@example.com",
  • "password": "your_password"
}

Response samples

Content type
application/json
{
  • "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

Login with API Key

Authenticate using an API key to get a JWT token

Request Body schema: application/json
required
X-Api-Key
required
string

Responses

Request samples

Content type
application/json
{
  • "X-Api-Key": "your_api_key_here"
}

Response samples

Content type
application/json
{
  • "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

Search NIGSAC Database

Advanced fuzzy search in the NIGSAC (Nigeria Financial Intelligence Unit Sanctions and Compliance) database. Supports searching for individuals, entities, and ID numbers with sophisticated fuzzy matching algorithms including Jaro-Winkler similarity, SOUNDEX phonetic matching, and Damerau-Levenshtein distance.

Authorizations:
ApiKeyAuth
Request Body schema: application/json
required
search_type
required
string
Enum: "Individual" "Entity" "ID Number"

Type of search to perform

first_name
string

First name for Individual search (required for Individual search if last_name not provided)

last_name
string

Last name for Individual search (required for Individual search if first_name not provided)

entity_name
string

Entity name for Entity search (required for Entity search)

id_number
string

ID number for ID Number search (required for ID Number search)

fuzzy_value
integer [ 0 .. 100 ]
Default: 80

Fuzzy matching threshold (0-100). Higher values require closer matches. Default is 80.

country
string

Filter results by country (optional)

dob_day
string

Day of birth (1-31) for Individual search

dob_month
string

Month of birth (1-12 or month name) for Individual search

dob_year
string

Year of birth (YYYY) for Individual search

Responses

Request samples

Content type
application/json
Example

Search for a person using first and last name with fuzzy matching

{
  • "search_type": "Individual",
  • "first_name": "sahabi",
  • "last_name": "Isail",
  • "fuzzy_value": 80,
  • "country": "Nigeria"
}

Response samples

Content type
application/json
{
  • "success": true,
  • "results": [
    ],
  • "count": 1
}

Get All Banks

Retrieve a list of all banks in the system

Authorizations:
ApiKeyAuth

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "banks": [
    ]
}

Get All Countries

Retrieve a list of all countries

Authorizations:
ApiKeyAuth

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "countries": [
    ]
}

Get Countries with Currency Codes

Retrieve a list of all countries with their currency codes and capitals

Authorizations:
ApiKeyAuth

Responses

Response samples

Content type
application/json
{
  • "status": "success",
  • "data": [
    ]
}

Get Country by Code

Retrieve a specific country by its country code

Authorizations:
ApiKeyAuth
path Parameters
code
required
string^[A-Z]{2}$
Example: NG

Two-letter country code (e.g., NG, US, GB)

Responses

Response samples

Content type
application/json
{
  • "status": "success",
  • "data": {
    }
}

Get Report Indicators

Retrieve a list of all available report indicators for compliance reporting

Authorizations:
ApiKeyAuth

Responses

Response samples

Content type
application/json
[
  • "CILPA1",
  • "CILPA2",
  • "CILPA3",
  • "CMIA1",
  • "CMIA2",
  • "FGAD1",
  • "FXCD1"
]