Retrieve all KBA security questions

Retrieves all Knowledge-Based Authentication (KBA) questions that are configured.

Request

GET /GmaApi/kba/questions

Example cURL request

curl -X GET https://hostname/GmaApi/kba/questions -H 'Authorization: Bearer f49bc2a1-587e-4c20-b995-2d8a5bc10fb9'

Resource URI

https://hostname/GmaApi/kba/questions

Authorization header

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

Example response

{
    "status": "success",
    "entries": [
        {
            "questionNumber": 1,
            "questionTextByLanguage": {
                "hi": "in what year was your father bore in hindi?",
                "de-de": "In what year your father born in german?",
                "en-us": "In what year was your father born?",
                "af": "In what year was your father born in afrikan?",
                "zh-hk": "In what year was your father born in chinese?",
                "el": "In what year was your father born in Greek?",
                "zh": "In what year was your father born in chinese?",
                "cs": "V jakém roce se tvůj otec narodil?",
                "fr-be": "father born in french?",
                "bn-bn": "In what year was your father born? Bengali",
                "zu": "In what year was your father born in zulu?",
                "nl": "In welk jaar werd je vader geboren?",
                "tr": "In what year was your father born in turkish?"
            },
            "roleMappings": [],
            "deprecated": false
        },
        {
            "questionNumber": 2,
            "questionTextByLanguage": {
                "cs": "V jakém roce se vaše matka narodila?",
                "de-de": "In what year Mother born in german?",
                "en-us": "In what year was your mother born?",
                "fr-be": "In what year was your mother born in french?",
                "af": "In what year was your mother born in afrikan?",
                "zh-hk": "In what year was your mother born in chinese?",
                "el": "In what year was your mother born in Greek?",
                "bn-bn": "In what year was your motherborn in bengali?",
                "zu": "In what year was your mother born in zulu?",
                "zh": "In What year was your mother born in chinese?",
                "nl": "mothers born",
                "tr": "In what year was your mother born in turkish?"
            },
            "roleMappings": [],
            "deprecated": true
        },
        {
            "questionNumber": 3,
            "questionTextByLanguage": {
                "en-us": "What is the name of your childhood best friend?",
                "fr-be": "What is the name of your childhood best friend in french?",
                "el": "What is the name of your childhood best friend in Greek?",
                "zh": "What is the name of your childhood best friend in chinese?",
                "nl": "childhood best friend"
            },
            "roleMappings": [],
            "deprecated": true
        },
        
        {
            "questionNumber": 20,
            "questionTextByLanguage": {
                "cs": "do you hav life insurance czech?",
                "en-us": "Do you have life insurance?",
                "fr-be": "Do you have life insurance in french",
                "en-za": "do u have insurance in SA",
                "ca": "Do you have life insurance in catalan?"
            },
            "roleMappings": [],
            "deprecated": false
        },
    "totalCount": 25
}

Response parameters

Table 1. 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. Any LDAP query that exceeds a size limitation returns an error.
total_count The total number of KBA questions.
entries A list of KBA questions.
questionNumber A number that identifies a question.
questionTextByLanguage A list of language and question text pairs. The languages are in language code format, for example, en-us.
roleMappings Roles the question applies to. If your organization is not using different KBA questions for different roles, you can ignore the roleMappings parameter.
deprecated A question is deprecated if it is no longer in use for users who are responding to KBA questions and answers. A deprecated question is still maintained for users who registered with the question before it was deprecated. A value of false indicates that a question is active.