TIN Verification API: Nigerian Tax Identification Number

Use the LumiID TIN Verification API to validate Nigerian Tax Identification Numbers for both individuals and registered businesses. The API queries official Joint Tax Board (JTB) and Federal Inland Revenue Service (FIRS) databases in real time, helping you reduce fraud, simplify compliance, and automate tax verification during customer and merchant onboarding.

Overview

Property	Value
Country	🇳🇬 Nigeria
Data Sources	Joint Tax Board (JTB) · Federal Inland Revenue Service (FIRS)
Verification Type	Tax Identification Number (TIN)
Typical Latency	< 2 seconds
Sandbox	Supported
Compliance	NDPR Ready

Endpoint

`POST /v1/ng/tin/`

Base URL: https://api.lumiid.com

Headers

Header	Value
`Authorization`	`Bearer YOUR_SECRET_KEY`
`Content-Type`	`application/json`

Request body

string

required

The Tax Identification Number to verify. Submit the TIN exactly as issued — do not include spaces or special characters.Example: 12345678

{
  "tin": "12345678"
}

Success response

{
  "success": true,
  "code": "TIN_VERIFIED",
  "message": "TIN verification successful",
  "summary": {
    "verified": true,
    "verification_type": "TIN",
    "provider": "LumiID",
    "confidence_score": 1.0
  },
  "data": {
    "tin": "12345678",
    "name": "LUMIID TECH LTD",
    "tax_office": "MSTO LAGOS",
    "business_type": "CORP"
  },
  "meta": {
    "request_id": "req_a1b2c3d4e5",
    "timestamp": "2026-03-19T08:14:22.445821Z"
  }
}

Response fields

boolean

Indicates whether the verification completed successfully.

string

Machine-readable response code (e.g. TIN_VERIFIED).

string

Human-readable response message.

object

High-level verification summary.

Show summary fields

boolean

Whether the TIN was successfully verified.

string

Always TIN for this endpoint.

string

Always LumiID.

number

Verification confidence on a scale of 0 to 1.

object

The verified tax registration record.

Show data fields

string

The verified Tax Identification Number.

string

Registered taxpayer or business name as held by the tax authority.

string

The tax office assigned to this taxpayer.

string

Taxpayer category. Returns CORP for registered businesses or INDIVIDUAL for natural persons.

object

Request metadata.

Show meta fields

string

Unique request identifier for auditing and support.

string

UTC response timestamp in ISO 8601 format.

Error codes

HTTP	Code	Resolution
400	`INVALID_REQUEST`	Missing or invalid `tin` in the request body.
400	`TIN_VERIFICATION_FAILED`	Verification could not be completed. Verify the TIN and retry.
401	`INVALID_API_KEY`	Authentication failed. Verify your API credentials.
401	`UNAPPROVED_ORGANIZATION`	Complete organization approval before accessing Production APIs.
401	`SUBSCRIPTION_REQUIRED`	Enable the TIN Verification service in the LumiID Console.
402	`INSUFFICIENT_FUNDS`	Your LumiID wallet balance is too low. Top up before retrying.
404	`TIN_NOT_FOUND`	No matching tax record exists for the supplied TIN.
500	`SERVER_ERROR`	Unexpected internal error. Retry once or contact LumiID Support.
503	`SERVICE_UNAVAILABLE`	The tax verification service is temporarily unavailable. Retry after a short delay.
504	`TIMEOUT`	The verification request timed out. Retry with exponential backoff.

Recommended business onboarding flow

Follow this workflow to fully verify a business’s legal identity, tax registration, and banking details before activation.

Verify CAC Registration Number

Call the CAC Business Verification API to confirm the company is registered and active with the Corporate Affairs Commission.

Verify the TIN

Call POST /v1/ng/tin/ to confirm the company holds a valid Tax Identification Number and that the registered name matches your records.

Verify the business bank account via NUBAN API

Use the NUBAN Verification API to confirm the bank account belongs to the same legal entity before disbursing funds or activating payouts.

Continue onboarding

After all checks pass, activate the business account with a complete audit trail covering registration, tax identity, and banking verification.

This workflow ensures the legal identity, tax registration, and banking details of every business are validated before activation.

Code example

Python

import requests

url = "https://api.lumiid.com/v1/ng/tin/"

headers = {
    "Authorization": "Bearer YOUR_SECRET_KEY",
    "Content-Type": "application/json"
}

payload = {
    "tin": "12345678"
}

response = requests.post(
    url,
    json=payload,
    headers=headers
)

print(response.json())

Security and compliance

Handle all returned taxpayer information in accordance with the Nigeria Data Protection Regulation (NDPR) and applicable tax privacy requirements. Do not store or share TIN data beyond your stated compliance purpose.

Tax records are retrieved directly from official Joint Tax Board (JTB) and Federal Inland Revenue Service (FIRS) databases.
All API requests must be made over HTTPS.
Every successful verification includes a unique request_id for auditing and troubleshooting.
Each successful verification consumes one wallet credit from your LumiID account.
Process returned taxpayer information in line with the Nigeria Data Protection Act (NDPA) and your organization’s data handling policies.

Get Started

General

Government Verification

Business Verification

Biometric & AML

SDKs & Integration

Reference

TIN Verification API: Nigerian Tax Identification Number

Overview

Endpoint

`POST /v1/ng/tin/`

Headers

Request body

Success response

Response fields

Error codes

Recommended business onboarding flow

Code example

Security and compliance

​Overview

​Endpoint

​POST /v1/ng/tin/

​Headers

​Request body

​Success response

​Response fields

​Error codes

​Recommended business onboarding flow

​Code example

​Security and compliance

Overview

Endpoint

`POST /v1/ng/tin/`

Headers

Request body

Success response

Response fields

Error codes

Recommended business onboarding flow

Code example

Security and compliance