Skip to main content
GET
/
api
/
v1
/
kyc
/
tin
Lookup TIN
curl --request GET \
  --url https://api.dojah.io/api/v1/kyc/tin \
  --header 'AppId: <appid>' \
  --header 'Authorization: <api-key>'
import requests

url = "https://api.dojah.io/api/v1/kyc/tin"

headers = {
"AppId": "<appid>",
"Authorization": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {AppId: '<appid>', Authorization: '<api-key>'}};

fetch('https://api.dojah.io/api/v1/kyc/tin', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://api.dojah.io/api/v1/kyc/tin",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"AppId: <appid>",
"Authorization: <api-key>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "https://api.dojah.io/api/v1/kyc/tin"

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("AppId", "<appid>")
req.Header.Add("Authorization", "<api-key>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://api.dojah.io/api/v1/kyc/tin")
.header("AppId", "<appid>")
.header("Authorization", "<api-key>")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.dojah.io/api/v1/kyc/tin")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["AppId"] = '<appid>'
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body
{
  "entity": {
    "search": "21148119-0001",
    "taxpayer_name": "SOLUTIONS NIGERIA LIMITED LAGOS",
    "cac_reg_number": "1435631",
    "firstin": "21148119-0031",
    "jittin": "N/A",
    "tax_office": "MSTO IKOYI",
    "phone_number": "07852417676",
    "email": "tola@hotmail.com"
  }
}
{
  "error": "Invalid request parameters"
}
{
  "error": "App Couldn't be Validated"
}

What is TIN ?

TIN means Tax Identification Number. It is an identification number used for tax purposes
AppId
string
required
Application ID from dashboard

Query parameter

tin
string
required
Tax Identification Number

RESPONSES

200
json
json
400
Object
401
Object
{
  "entity": {
    "search": "21148119-0001",
    "taxpayer_name": "SOLUTIONS NIGERIA LIMITED LAGOS",
    "cac_reg_number": "1435631",
    "firstin": "21148119-0031",
    "jittin": "N/A",
    "tax_office": "MSTO IKOYI",
    "phone_number": "07852417676",
    "email": "tola@hotmail.com"
  }
}
{
  "error": "Invalid request parameters"
}
{
  "error": "App Couldn't be Validated"
}