IDENTITY VERIFICATION

TIN Verification

Verify business entities and individuals via their Tax Identification Number or CAC Registration Number.

POST /api/v1/tin

Authentication & Headers

HEADER	VALUE	REQUIRED
`Authorization`	`Bearer YOUR_API_TOKEN`	Yes

Request Parameters

PARAMETER	TYPE	DESCRIPTION	REQUIRED
`tin`	string	The Tax Identification Number or CAC Registration Number.	Required

Example Request

cURL

curl -X POST "https://www.api.arewasmart.com.ng/api/v1/tin" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -d "tin=12345678-0001"

Success Response (200 OK)

{
    "status": true,
    "message": "TIN Verified",
    "data": {
        "taxpayer_name": "Arewa Smart Idea",
        "taxpayer_type": "Corporate",
        "tax_office": "Lagos"
    }
}