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

{
  "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"
  }
}
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"
   }'

Last updated