Validate an answer to a KBA security question

Validates the answer that is given by a user to a Knowledge-Based Authentication (KBA) question.

Request

POST
/GmaApi/users/{gtwayUUID}/kba/checkAnswer

Example cURL requests

# curl -v -X POST -H
"Content-Type:application/x-www-form-urlencoded" -H "Authorization: Bearer
644d0ac0-908f-485a-ac8d-b5bb99f200d7" -d "questionNumber=3&answer=1977"
https://hostname/GmaApi/users/68567181-2cf1-4b2b-bc10-6d6f05afb8e7/kba/checkAnswer

# curl -v -X POST -H "Authorization: Bearer 644d0ac0-908f-485a-ac8d-b5bb99f200d7" -d "questionNumber=3&answer=1977" https://hostname/GmaApi/users/68567181-2cf1-4b2b-bc10-6d6f05afb8e7/kba/checkAnswer

Resource URI

https://hostname/GmaApi/users/{gtwayUUID}/kba/checkAnswer

Authorization header

For information about obtaining an access token, see Request an access token.

Request content type

x-www-form-urlencoded.

Request parameters

Table 1. Path parameters
Parameter	Type	Required	Description
gtwayUUID	String	Yes	The gtwayUUID for the user whose answer you want to validate. Note: You can use the `GET /GmaApi/users/{username}` method to retrieve the gtwayUUID of a user.

Table 2. Request body parameters
Parameter	Type	Required	Description
questionNumber	Integer	Yes	The question number.
answer	String	Yes	The answer to the question.

Example response

{"status":"success"}

Response parameters

Table 3. Response parameters
Parameter	Description
status	Returns whether the request was successful. Returns an error when the request is unsuccessful. For more information about errors, see Errors.