Skip to content

Flow Result

Description#

This section contains examples of results returned after completing various verification technologies. Each example is accompanied by a detailed description of the data structure and possible statuses.

Note

The examples below contain test data. In real requests, field values will correspond to the specific subject's information.

For more details on obtaining the Flow completion result, refer to the section Flow Remote.

Terms#

  • Subject - an individual undergoing the verification process or providing consent for data processing.
  • 1414 - a unified number for sending SMS messages related to government services in the Republic of Kazakhstan.
  • IIN - Individual Identification Number, a unique number assigned to a person.
  • GBDFL (State Database of Individuals) - a centralized database containing information about individuals in the Republic of Kazakhstan.

GBDFL - Retrieving Information About an Individual#

This technology retrieves verified information about an individual from the State Database of Individuals (GBDFL). Obtaining this data requires the subject's consent, which is provided via an SMS sent from number 1414.

Possible Response Statuses#

  • VALID - data successfully retrieved after confirmation by the subject
  • INVALID - the subject declined the request for data
  • PENDING - waiting for the subject's response
  • TIMEOUT - response time has expired

Successful Response (Status VALID)#

If the data is successfully retrieved, the response contains comprehensive information about the individual:

  • Basic personal data (Full name, date of birth, gender)
  • Citizenship and nationality information
  • Place of birth
  • Document details
  • Registration address
{
    "id": "a6b8c5e3-fcde-4b12-8a4f-7e0d5b8c091a",
    "technologies": [
        {
            "name": "GBDFL Technology",
            "description": "Get information about person from gbdfl",
            "code": "GBDFL"
        }
    ],
    "gbdfl_result": {
        "iin": "123456789012",
        "result_json": {
            "gbdfl_response": {
                "iin": "123456789012",
                "surname": "Ivanov",
                "name": "Ivan",
                "patronymic": "Ivanovich",
                "birth_date": "1990-01-01",
                "gender": "Male",
                "nationality": "Kazakh",
                "citizenship": "Kazakhstan",
                "life_status": "Alive",
                "birth_place": {
                    "country": "Kazakhstan",
                    "region": "Almaty Region",
                    "district": "Taldykorgan",
                    "city": "Taldykorgan"
                },
                "documents": [
                    {
                        "type": "Kazakhstan Passport",
                        "number": "N12345678",
                        "issue_date": "2020-01-01",
                        "expiry_date": "2030-01-01",
                        "issuer": "Ministry of Internal Affairs of RK",
                        "status": "Document valid"
                    },
                    {
                        "type": "Kazakhstan ID Card",
                        "number": "123456789",
                        "issue_date": "2015-05-01",
                        "expiry_date": "2025-05-01",
                        "issuer": "Ministry of Internal Affairs of RK",
                        "status": "Document valid"
                    }
                ],
                "registration_address": {
                    "country": "Kazakhstan",
                    "region": "Almaty Region",
                    "district": "Taldykorgan",
                    "city": "Taldykorgan",
                    "street": "Abay Street",
                    "building": "45",
                    "flat": "12",
                    "begin_date": "2010-06-15"
                }
            }
        },
        "status": "VALID",
        "result": true
    },
    "flow_session_result": true
}

Data Access Denied (Status INVALID)#

If the subject declines to provide access to their data via SMS, the system returns a response with the status INVALID.

{
    "id": "b9a2d67e-1a74-4cfa-b2a6-45f1ebc238ab",
    "technologies": [
        {
            "name": "GBDFL Technology",
            "description": "Get information about person from gbdfl",
            "code": "GBDFL"
        }
    ],
    "gbdfl_result": {
        "iin": "123456789012",
        "status": "INVALID"
    },
    "flow_session_result": false
}

Waiting for Response (Status PENDING)#

The status PENDING indicates that the request result is in an intermediate state.

This can occur for the following reasons:

  • The system has just sent an SMS with a consent request
  • The subject has received the SMS but has not yet responded
  • The system is processing the subject's response
  • The response waiting period has not yet expired

In this case, it is recommended to retry the result request after some time. 

{
    "id": "c7d4e3a2-5fd6-4e9b-937b-8af7c67b3d92",
    "technologies": [
        {
            "name": "GBDFL Technology",
            "description": "Get information about person from gbdfl",
            "code": "GBDFL"
        }
    ],
    "gbdfl_result": {
        "iin": "123456789012",
        "status": "PENDING"
    },
    "flow_session_result": false
}

Response Time Expired (Status TIMEOUT)#

The status TIMEOUT is returned when the maximum waiting time for the subject's response has been exceeded. This may occur if the subject does not respond to the SMS within the allocated time.

{
    "id": "d8e5f2b1-3c9a-4d8b-ae5f-2c974d6b1e3a",
    "technologies": [
      {
        "name": "GBDFL Technology",
        "description": "Get information about person from gbdfl",
        "code": "GBDFL"
      }
    ],
    "gbdfl_result": {
      "iin": "123456789012",
      "status": "TIMEOUT",
      "expire_date": "2023-12-16T14:30:00Z"
    }, 
    "flow_session_result": false
}