Kazakhstan

Sample structures of the E_KYC_CHECK API responses for Kazakhstan E-residency Non-Doc Identity Verification (kaz_gov_erp).

GREEN

The following response example represents successful checks.

{
  "checks": [
    {
      "answer": "GREEN",
      "checkType": "E_KYC_CHECK",
      "createdAt": "2026-08-14 10:59:03",
      "id": "1654764e-2fb3-4f39-aeca-e8bf962a97bb",
      "sourceInfo": {
        "id": "kaz_gov_erp"
      },
      "inputDoc": {
        "idDocType": "TAX_PAYER_NUMBER_DOC",
        "country": "KAZ",
        "number": "001122049317"
      },
      "extractedDoc": {
        "country": "KAZ",
        "number": "440293817556",
        "firstName": "OLENA",
        "lastName": "KOVALCHUK",
        "gender": "F",
        "phone": "77026789012",
        "email": "[email protected]",
        "issueAuthority": "1455",
        "dob": "2000-11-22",
        "addresses": [
          {
            "flatNumber": "7",
            "street": "Svobody Avenue",
            "buildingNumber": "28",
            "town": "Lviv",
            "postCode": "79008",
            "country": "UKR",
            "source": "externalDb"
          }
        ],
        "placeOfBirth": "Lviv",
        "countryOfBirth": "UKR",
        "tin": "001122049317",
        "validUntil": "2028-02-09",
        "images": [
          {
            "imageId": 501111398
          }
        ],
        "additionalDocs": [
          {
            "country": "UKR",
            "idDocType": "PASSPORT",
            "number": "FK582093",
            "issueDate": "2018-09-03",
            "validUntil": "2028-09-02"
          }
        ]
      },
      "ekycCheckInfo": {}
    }
  ]
}

RED / ERROR

The following response example represents a case when no data was found.

{
  "checks" : [ {
    "answer" : "ERROR",
    "checkType" : "E_KYC_CHECK",
    "createdAt" : "2026-07-01 10:12:12",
    "id" : "gbg4570d-8431-3422-9g89-570226ac9sto",
    "inputDoc" : {
      "idDocType" : "TAX_PAYER_NUMBER_DOC",
      "country" : "KAZ",
      "tin": "001122049317"
    },
    "ekycCheckInfo" : { }
  } ]
}

Response explained

Root variables

The root variables (in the checks array) are the core check result data items. Some of them may include nested attributes and element fields.

Field	Type	Description
`id`	String	Unique identifier of the check.
`answer`	String	Verification result: `GREEN` (passed) or `RED/ERROR` (no data found).
`checkType`	String	Indicates that it is a `E_KYC_CHECK` check type.
`createdAt`	Date	Date and time (UTC) of the check result, in format `YYYY-MM-DD HH:mm:ss`.
`sourceInfo.id`	String	Unique ID of the Database Solution used (`kaz_gov_erp`).
`inputDoc`	Object	Data used as input for the database verification.
`extractedDoc`	Object	Data retrieved from the external source.
`ekycCheckInfo`	Object	May include face-matching results and Non-Doc verification metadata; can be empty.

`inputDoc` attributes

Field	Type	Description
`idDocType`	String	Type of the document or data provided for verification (for example, `TAX_PAYER_NUMBER_DOC`).
`country`	String	Alpha-3 country code (for example, `KAZ`).
`number`	String	Identification number provided by the applicant.

`extractedDoc` attributes

Field	Type	Description
`country`	String	Alpha-3 country code (for example, `KAZ`).
`number`	String	Identification number retrieved from the external source.
`firstName`	String	Applicant first name.
`lastName`	String	Applicant last name.
`gender`	String	Gender of the applicant (`M` or `F`).
`phone`	String	Applicant phone number.
`email`	String	Applicant email address.
`issueAuthority`	String	Official name of the authority that issued the document.
`dob`	Date	Applicant date of birth, in format `YYYY-mm-dd` (for example, `2000-11-22`).
`addresses`	Array of objects	Applicant address details retrieved from the external database.
`placeOfBirth`	String	Applicant place of birth.
`countryOfBirth`	String	Alpha-3 country code of birth (for example, `KAZ`).
`tin`	String	Taxpayer identification number.
`validUntil`	Date	Date when the document validity expires, in format `YYYY-mm-dd`.
`images`	Array of objects	IDs of images obtained from the external database.
`additionalDocs`	Array of objects	Additional documents returned by the external database.

`addresses` element fields

Field	Type	Description
`flatNumber`	String	Flat or apartment number.
`street`	String	Street name.
`buildingNumber`	String	Building number.
`town`	String	City, town, or another settlement.
`postCode`	String	Address postal code.
`country`	String	Alpha-3 country code (for example, `KAZ`).
`source`	String	Always `externalDb`. Indicates the address was retrieved from the external database.

`images` element fields

Field	Type	Description
`imageId`	Integer	ID of the image obtained from the external database.

`additionalDocs` element fields

Field	Type	Description
`country`	String	Alpha-3 country code of the additional document (for example, `KAZ`).
`idDocType`	String	Type of the additional document (for example, `PASSPORT`).
`number`	String	Additional document number.
`issueDate`	Date	Date when the additional document was issued, in format `YYYY-mm-dd`.
`validUntil`	Date	Date when the additional document validity expires, in format `YYYY-mm-dd`.