TIN Verification API

The TIN (Tax Identification Number) Verification API allows you to verify tax records of individuals or organizations using their TIN numbers. This helps ensure accurate tax identity validation and compliance.

Base URL

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

Endpoints

POST /verify

Verify a TIN number and retrieve registration details of the taxpayer.

Headers:

    Authorization: Bearer <your_api_key>
Content-Type: application/json

Request Body:

            {
          "tin": "12345678"
           }

Successful Response (200):

    
          {
      "status": "success",
      "data": {
        "tin": "12345678",
        "name": "John Doe Enterprises",
        "tax_office": "Lagos Mainland",
        "registration_date": "2015-06-12",
        "business_type": "Limited Liability"
        }
      }

Error Response (400):

           
            {
            "status": "error",
            "message": "Invalid or unregistered TIN number."
          }

Example Integration

Python Example

    
      import requests

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

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

JavaScript Example

    
      fetch("https://lumiid.com/api/v1/ng/tin", {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
      },
      body: JSON.stringify({
        tin: "12345678"
      })
      })
      .then(response => response.json())
      .then(data => console.log(data))
      .catch(error => console.error(error));

Common Error Codes

400: Missing or invalid TIN field
401: Invalid or expired API key
404: Record not found
500: Internal server error (retry later)

Important Notes

All data is retrieved directly from the Tax Identification Number database.
Use HTTPS endpoints only — requests over HTTP will be rejected.
Each request consumes one credit from your LumiID wallet.
Ensure you handle user data responsibly and comply with NDPR regulations.