---
description: >-
  Use this endpoint to retrieve the first question to verify customer identity
  using the Q&A method.
---

# Retrieve First Question

## Retrieve First Question

<mark style="color:green;">`POST`</mark> `/onboard/verify`

After initiating an onboarding request, you can begin verifying the customer’s identity through a series of Q\&A sessions retrieved from the NIDA database. Use this endpoint to retrieve the first question and start the Q\&A process.

#### Headers

| Name                                            | Type   | Description                          |
| ----------------------------------------------- | ------ | ------------------------------------ |
| authorization<mark style="color:red;">\*</mark> | string | Authorization Bearer token           |
| x-request-id<mark style="color:red;">\*</mark>  | string | A unique id identifying this request |

#### Request Body

| Name                                        | Type   | Description                                                |
| ------------------------------------------- | ------ | ---------------------------------------------------------- |
| onboardId<mark style="color:red;">\*</mark> | string | Onboard ID returned after initiating an onboarding session |

{% tabs %}
{% tab title="200 Transfer was successful" %}
```javascript
{
  "id": "2024080211055020554100688170",
  "code": "120",
  "result": {
    "questionCode": "103",
    "nin": "XXXXXXXXXXXXX",
    "questionEnglish": "Mention your mobile number",
    "questionSwahili": "Taja namba ya simu uliyoweka kipindi unasajiliwa"
  }
}

```
{% endtab %}

{% tab title="401: Unauthorized Unauthorized request" %}

{% endtab %}

{% tab title="400: Bad Request Validation error" %}
```javascript
{
    "statusCode": 400,
    "reason": "VALIDATION_ERROR",
    "details": {
        "onboardId": "onboardId cannot be emtpy"
    }
}
```
{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Curl" %}
```shell
curl --request POST \
  --url https://sandbox.temboplus.com/onboard/v1/onboard/verify \
  --header 'content-type: application/json' \
  --header 'authorization: Bearer <your token>' \
  --header 'x-request-id: 546d7a200cd8cb45d8ac' \
  --data '{
	"onboardId": "1JpXezddTbXH"
   }'

```
{% endtab %}
{% endtabs %}

