System Upgrade v3.1

Unified Identity Verification

Securely verify identities across African borders using our sovereign data rails. Integrate biometric, corporate, and financial records in a single request.

Compliance API v1.1.0-stable

TIN Verification

Verify the Tax Identification Number (TIN) for individuals and corporate entities across Nigeria. Our API connects directly to the JTB (Joint Tax Board) and FIRS records to provide real-time validation of tax identity and registration status.

Endpoint Details

POST https://api.lumiid.com/v1/ng/tin/verify

All requests must be authenticated using your secret bearer token. Ensure your wallet has sufficient credits before making a call.

Request Parameters

Key	Type	Required
tin	string	Required

Standard Error Responses

404: Not Found

The TIN provided does not exist in the official tax registers.

400: Bad Request

Malformed JSON or missing the "tin" field in request body.

Python Request

import requests

url = "https://api.lumiid.com/v1/ng/tin/"
headers = {
    "Authorization": "Bearer YOUR_KEY",
    "Content-Type": "application/json"
}

response = requests.post(url, 
    json={"tin": "12345678"}, 
    headers=headers
)
print(response.json())

Sample JSON Response

{
  "success": true,
  "code": "TIN_VERIFIED",
  "data": {
    "name": "LUMIID TECH LTD",
    "tax_office": "MSTO LAGOS",
    "business_type": "CORP"
  },
  "meta": {
    "request_id": "req_a1b2..."
  }
}