Skip to content

Search and verify companies in Nigeria through Corporate Affairs Commission and Federal Inland Revenue Service

License

Notifications You must be signed in to change notification settings

walebant/company-verify

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

company-verify

Company VERIFY is a Nodejs package that enables developers search and verify if a company is registered in Nigeria under the Corporate Affairs Commission and also retrieve their taxpayer details from Federal Inland Revenue Service

What can I do?
  • Search for a list of companies with a search query

  • Search taxpayer information by inputting company's RC number or TIN.

Getting Started

Installing

Package manager

Using npm:

npm  i  company-verify

Using yarn:

yarn add  company-verify

Usage

Once the package is installed, you can import the library using import or require approach:

import { firs_search, cac_search } from 'company-verify';

or

const { firs_search, cac_search } = require('company-verify');

search for a company details on FIRS

 /**
* @param {String}  criteria - RC or TIN
* @param {String}  query - RC number or TIN based on criteria
*/
async  function  getData()  {
	const  response  =  await  firs_search({ criteria:  "RC",  query:  "3067627"  });
	return  response;
}

//RESPONSES
//Success
{
    "success": true,
    "message": "",
    data: {
	"name": String,
	"tin": String,
	"rc": String,
	"jtbTIN": String,
	"taxOffice": String,
	"phone": String,
	"email": String
    }
}

//Not Found
{ "success": true,  message:  'Not found'}

//Incorrect criteria value
{ "success": false,  message:  `Invalid Criteria. Can either be "TIN" or "RC"`}

search for a company on CAC

 /**
* @param {String}  searchTerm - part or full name of company
*/
async  function  getData()  {
	const  response  =  await  cac_search({ searchTerm:  "dangote group"  })
	return  response;
}

//RESPONSES
//Success
{
    "status": "OK",
    "success": Boolean,
    "errorCode": Number,
    "data": [
      {
	"active": Boolean,
	"email": String | null,
	"natureOfBusinessName": String,
	"id": Number,
	"approvedName": String,
	"rcNumber": String,
	"city": String,
	"lga": String | null,
	"classification": String,
	"registrationApproved": boolean,
	"branchAddress": String,
	"registrationDate": Date,
	"classificationId": Number,
	"headOfficeAddress": String | null,
	"businessCommencementDate": String | null,
	"objectives": String,
	"delistingStatus": String | null,
	"companyTypeName": String,
	"searchScore": Float,
	"address": String",
	"state": String
      },
    ],
    "message": "See Data Object for Details",
    "timestamp": Date
}

About

Search and verify companies in Nigeria through Corporate Affairs Commission and Federal Inland Revenue Service

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published