TIN Lookup Integration Guide
Last updated Dec 17th, 2023
Overview
Our TIN Lookup service enables you to retrieve critical information associated with a Tax Identification Number (TIN). This guide will take you through the process of integrating this service into your application, allowing you to seamlessly access TIN-related details.
Prerequisites
To get started, please ensure to:
- Sign up on the Mono Dashboard.
- Create an App and fetch the generated Secret Key.
Integration Steps
Step 1: Make a TIN Lookup Request
To retrieve TIN-related information, send a POST request to the following endpoint:
Request
POST https://api.withmono.com/v3/lookup/tin
Request Body Parameters
number
(required): Provide the Tax Identification Number (TIN) or the Corporate Affairs Commission (CAC) RC number for the lookup.channel
(required): Specify the channel as "tin" or "cac".
Include these two parameters in the request body to specify the TIN number and channel for the lookup.
Request Headers
Include the following header in your request for authentication:
mono-sec-key
(required): Your Mono secret key.
cURL Sample Request
Request
curl -X POST \
-H "Content-Type: application/json" \
-H "mono-sec-key: YOUR_MONO_SECRET_KEY" \
-d '{
"number": "TIN_NUMBER",
"channel": "tin"
}' \
https://api.withmono.com/v3/lookup/tin
Step 2: Process the Response
If the TIN lookup request is successful, you will receive the following response:
Request
{
"status": "successful",
"message": "Lookup Successful",
"timestamp": "2024-05-09T13:12:02.570Z",
"data": {
"taxpayer_name": "NOMO TECHNOLOGIES NIGERIA LIMITED",
"cac_reg_number": "RC0000015",
"firstin": "20000071-0001",
"jittin": null,
"tax_office": "LTO Non Oil (Financial)",
"phone_number": "08012345678",
"email": "hi@nomo.co"
}
}
The response includes essential TIN-related information such as email, name, organization number, phone number, registration number, street name, tax office, TIN source, TIN type, search details, and more.