> For the complete documentation index, see [llms.txt](https://capitalsage.gitbook.io/sagecloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://capitalsage.gitbook.io/sagecloud/kyc/verify-nin.md).

# Verify NIN

## Verify Customer NIN Details

<mark style="color:green;">`POST`</mark> `https://sagecloud.ng/api/v2/kyc/verify-nin`

This endpoint allows you to verify customer nin details

#### Headers

| Name                                            | Type   | Description             |
| ----------------------------------------------- | ------ | ----------------------- |
| Authorization<mark style="color:red;">\*</mark> | string | Check the Headers page. |

#### Request Body

| Name                                    | Type   | Description           |
| --------------------------------------- | ------ | --------------------- |
| nin<mark style="color:red;">\*</mark>   | string | Customer NIN          |
| phone<mark style="color:red;">\*</mark> | string | Customer Phone Number |

{% tabs %}
{% tab title="200 Below is a sample response." %}

```
{
    "success": true,
    "message": "NIN Verification Completed Successfully",
    "data": {
        "request_reference": "EWTDSr129575336",
        "nin_number": "99884466222",
        "document_no": "",
        "verification_status": "VERIFIED",
        "service_type": "NIN Verification",
        "personal_info": {
            "title": "mr",
            "first_name": "THIAME",
            "middle_name": "ALIUNE",
            "last_name": "BENSON",
            "full_name": "THIAME ALIUNE BENSON",
            "maiden_name": "",
            "gender": "m",
            "phone_number": "08277332211",
            "date_of_birth": "09-02-1962",
            "formatted_date_of_birth": "Sept 2, 1962",
            "height": "",
            "marital_status": "single",
            "image_url": "https://api.blusalt.net/_/gndrz1UWITUSqR-",
            "religion": "islam"
        },
        "next_of_kin": {
            "firstname": "****",
            "surname": "****",
            "address": "****",
            "lga": "****",
            "town": "****",
            "state": "****"
        },
        "residential_info": {
            "address": "91 BAYERO STREET",
            "lga_of_residence": "Ayelagbe",
            "state_of_residence": "Osun",
            "residence_status": "birth"
        },
        "indigene_info": {
            "lga_of_origin": "Ayelagbe",
            "place_of_origin": "****",
            "state_of_origin": "Osun",
            "lga_of_birth": "Ayelagbe",
            "state_of_birth": "Osun",
            "country_of_birth": "nigeria"
        },
        "education_profession": {
            "educational_level": "tertiary",
            "profession": "FRENCH TEACHER"
        }
    }
}
```

{% endtab %}

{% tab title="401 " %}

```
{    
    "message": "Unauthenticated."
}
```

{% endtab %}
{% endtabs %}
