> For the complete documentation index, see [llms.txt](https://axis-docs.fuspay.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://axis-docs.fuspay.finance/create-kyc.md).

# Create KYC

<mark style="color:green;">`POST`</mark> `https://exchanger-api.fuspay.finance/api/v1/no-auth/Axis/CreateUserKyc`

#### Request Headers

| Name                                            | Type   | Description                      |
| ----------------------------------------------- | ------ | -------------------------------- |
| Authorization<mark style="color:red;">\*</mark> | String | "Bearer ${partner\_secret\_key}" |
| x-partner-id<mark style="color:red;">\*</mark>  | String | "pxxxxxx"                        |

#### Request Body

<table><thead><tr><th width="181">Name</th><th width="135">Type</th><th>Description</th></tr></thead><tbody><tr><td>full_name</td><td>string</td><td>the full name of your user</td></tr><tr><td>email</td><td>String</td><td>your user's email address </td></tr><tr><td>phone</td><td>String</td><td> your user's phone number</td></tr><tr><td>callback</td><td>String</td><td>This is the URL where KYC status of your user would be posted after they have completed their KYC </td></tr><tr><td>reference</td><td>String</td><td>This is an identifier for your user from your end</td></tr><tr><td>type</td><td>String</td><td>This is the type of KYC (it is either Individual or Business)</td></tr></tbody></table>

Sample code

```json
{
    "full_name": "Balogun Emmanuel",
    "email": "toyeric902@gmail.com",
    "phone":"08062551247",
    "callback":"https://webhook.site/e93182e8-6412-351b7ebb682c",
    "reference":"1000000",
    "type":"Individual"
}
```

{% hint style="success" %}
Initiated Data is what was received via API Call while Verified Data is what the user eventually submitted.
{% endhint %}

{% tabs %}
{% tab title="200: OK successful response" %}
{% code overflow="wrap" %}

```json
{
    "success": true,
    "message": "CreateUserKyc",
    "data": {
        "_id": "67069ad9002d0b1ec",
        "email": "toyeric902@gmail.com",
        "full_name": "Balogun Emmanuel",
        "phone": "08012345678",
        "kyc_type": "Individual",
        "kyc_url": "https://kyc.fuspay.finance/verification/individual/67009002d0b1ec",
        "reference": "1000000",
        "callback": "https://webhook.site/e93182e8-6412-351b7ebb682c"
    }
}
```

{% endcode %}
{% endtab %}
{% endtabs %}

| Key      | Type   | Description                                                                | Value |
| -------- | ------ | -------------------------------------------------------------------------- | ----- |
| kyc\_url | string | This is the url that is returned to you for your customer to do their kyc. |       |