1. Home
  2. Docs
  3. Data Subscriber API Documentation
  4. Endpoints Reference
  5. POST /persons/:id/verify

POST /persons/:id/verify

Send answers to authentication questions. This will return additional authentication questions or authenticated status.

Headers

 

Key Value
Content-Type application/json
Authorization Bearer {token}

Request

 

Key Required Comment
answers Yes JSON array. Each object has keys “questionId” and “answerId”. E.g., [{“questionId”: “00001”, “answerId”: “0000A”}]
fulfillment_key Yes string. Received from /persons/:id/authenticate.

Response

Key Value
questions JSON array. Same format as in the response of /persons/:id/authenticate. These are more questions to be answered.
Null unless status code is 200.
fulfillment_key string. Must be used in another call to /person/:id/verify if more questions need answer.
Null unless status code is 200.
verified boolean.

Status Code

 

Code Comment
200 Verification OK, but more questions are prompted that need answers.
202 Verification completed. Income information complete.
203 Verification complete. Income information incomplete.
400 Wrong payload format.
401 Person not authenticated yet.
403 Not able to verify person.

How can we help?