# 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.

<Callout icon="⚠️" theme="warn">
  Nigeria eKYB is currently available only in the Incode demo environment, not in production. Contact Incode support for availability.
</Callout>

Directors are not currently supported for Nigeria.&#x20;

## 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](https://developer.incode.com/docs/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

```json
{
  "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

```json
{
  "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](https://developer.incode.com/docs/ekyb-api-reference) for standard error responses.

## Single Session Dashboard results

View eKYB results on the Business tab in [single Session view](https://developer.incode.com/docs/single-session-view).