Reply to Question

Use this endpoint to reply to a security question to verify customer identity.

Reply to a Question

POST /onboard/verify

Use this endpoint to respond to KYC questions retrieved from the NIDA database. After submitting your response, a new question will be returned. Continue responding to questions until you are successful, in which case code 00 will be returned.

If code 120 is returned, the result field will contain another question that you must also respond to. Any other code indicates that verification has failed.

Headers

Name	Type	Description
authorization*	string	Authorization Bearer token
x-request-id*	string	A unique id identifying this request

Request Body

Name	Type	Description
onboardId*	string	Onboard ID returned after initiating an onboarding session
questionCode	string	The code for the question you are responding to, as returned from NIDA
answer	string	The answer to the question you are responding to

200 Transfer was successful

{
  "id": "2024080211063707578493511177",
  "code": "120",
  "result": {
    "prevCode": "123",
    "questionCode": "106",
    "nin": "XXXXXXXXXXX",
    "questionEnglish": "Mention year of primary school completion",
    "questionSwahili": "Taja mwaka uliohitimu shule ya msingi"
  }
}

401: Unauthorized Unauthorized request

400: Bad Request Validation error

{
    "statusCode": 400,
    "reason": "VALIDATION_ERROR",
    "details": {
        "onboardId": "onboardId cannot be emtpy"
    }
}

Curl

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": "lS2Ju1biJuug",
	"questionCode": "106",
	"answer": "1997"
   }'