Nigeria

Nigeria eKYB validates the legitimacy of Nigerian businesses by checking their tax ID, business name, address, and UBOs against Nigerian government sources of truth.

Warning

Nigeria eKYB is currently available only in the Incode demo environment, not in production. Contact Incode support for availability.

Directors are not currently supported for Nigeria.

Source

Country	Source	Description
Nigeria	Nigerian government sources of truth	Verifies submitted business details against records maintained in Nigerian registries.

Direct API approach

For general integration notes and shared response semantics, see the eKYB API Reference.

Request parameters

Parameter	Required	Description
`plugins`	Mandatory	Array. Must be `["ekyb"]`.
`businessName`	Mandatory	String. Name of the business.
`country`	Mandatory	String. Two-letter Alpha-2 country code. Must be `NG`.
`taxId`	Mandatory	String. TIN (Tax Identification Number).
`street`	Optional	String. Street name of the business.
`houseNo`	Optional	String. Building or house number.
`addressLine2`	Optional	String. Second line of the business address.
`city`	Optional	String. City in the business address.
`state`	Optional	String. State in the business address.
`postalCode`	Optional	String. 6-digit Nigerian postal code.
`uboNames`	Optional	Array. Full legal names of Unique Beneficial Owners to check against records associated with the business.

Sample request

{
  "plugins": ["ekyb"],
  "businessName": "SkyBridge Aviation Services Ltd.",
  "street": "West Terminal Boulevard, Suite 310",
  "addressLine2": "3rd Floor Port Harcourt International Airport",
  "city": "Port Harcourt",
  "state": "Rivers",
  "postalCode": "500102",
  "country": "NG",
  "taxId": "NG-X-NG0000098712",
  "uboNames": ["Oluwaseun Okonkwo", "Marian Ekong"]
}

Sample response

{
  "kyb": [
    { "key": "name", "sub_label": "Verified" },
    { "key": "tin", "sub_label": "Verified", "reasonCodes": ["REGNO"] },
    { "key": "address_verification", "sub_label": "Verified" },
    { "key": "cityMatch", "sub_label": "Verified" },
    { "key": "state", "sub_label": "Verified" },
    { "key": "postalCodeMatch", "sub_label": "Verified" },
    { "key": "registrationStatus", "sub_label": "Active" },
    { "key": "entityType", "sub_label": "Private Company Limited by Shares (Ltd)" },
    { "key": "ubo_name_match", "sub_label": "Verified", "uboName_input": "Oluwaseun Okonkwo" },
    { "key": "ubo_name_match", "sub_label": "Unverified", "uboName_input": "Marian Ekong" }
  ]
}

Response fields

Key	Status	Description
`name`	`Verified`, `Approximate Match`, `Unverified`	Submitted business name against the business name associated with the tax ID.
`tin`	`Found`, `Not Found`	Submitted tax ID against the government database.
`address_verification`	`Verified`, `Approximate Match`, `Unverified`	Submitted address against the address associated with the tax ID.
`cityMatch`	`Verified`, `Approximate Match`, `Unverified`	Submitted city against the city associated with the tax ID.
`state`	`Verified`, `Approximate Match`, `Unverified`	Submitted state against the state associated with the tax ID.
`postalCodeMatch`	`Verified`, `Unverified`	Submitted postal code against the postal code associated with the tax ID.
`registrationStatus`	`Active`, `Inactive`, `Unknown`	Registration status of the business. `Inactive` includes suspended businesses and those no longer in operation.
`entityType`	Legal entity type of the business	The legal entity type of the company, if available. If not available, displays `Unknown`.
`ubo_name_match`	`Verified`, `Approximate Match`, `Unverified`	Submitted UBO against UBOs associated with the business. Distinguished by the `uboName_input` field on each entry.

Error responses

See the eKYB API Reference for standard error responses.

Single Session Dashboard results

View eKYB results on the Business tab in single Session view.