Integration Guide

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

Before you start integrating the TIN Lookup service, ensure you have the following:

Sign up on the Mono Dashboard ➡
Create an App and fetch the generated Secret Key ➡

With these prerequisites met, you can proceed to integrate the TIN Lookup service into your application using the steps provided below.

Step 1: Make a TIN Lookup Request

To retrieve TIN-related information, send a POST request to the following endpoint:

POST https://api.withmono.com/v3/lookup/tin

Request Body Parameters

number (required): Provide the Tax Identification Number (TIN) for the lookup.
channel (required): Specify the channel as "tin".

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

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:

{
  "status": "successful",
  "message": "Verification Successful",
  "data": {
    "email": "[email protected]",
    "id": "12345678-4321",
    "name": "REAL LIFE NIGERIA LIMITED",
    "organization_number": "RC1234567",
    "phone_number": "",
    "registration_number": "RC1234567",
    "street_name": "NO 5A, AHMADU WAY, LEKKI",
    "tax_office": "LTO Non Oil (Financial), LTLI",
    "tin_source": "FIRS",
    "tin_type": "CORPORATE",
    "search": "12345678-4321",
    "cac_reg_number": "RC1234567",
    "taxpayer_name": "REAL LIFE NIGERIA LIMITED",
    "number": "12345678-4321"
  }
}

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.