Skip to content

Document Scan Recognition (OCR)

Recognition and validation of document scans: Russian internal passport (old and new format), Russian international passport (old and biometric), driving license, and SNILS. Returns the recognized document data.

URL

Method: POST

  • Production: https://registry.wallet.kvell.group/reg2/validation/scan

Request parameters

Name Data type Required Description
file binary Yes Document scan file (image in JPEG, PNG, etc. format)

The request is sent as multipart/form-data with a file field.

Request headers

Name Data type Required Description
X-Api-Key string Yes Unique identifier (UUID)

Response

Example response

{
  "docType": "PASSPORT_RF",
  "license": {
    "series": "1234",
    "number": "123456",
    "issuedDate": "17.12.2004",
    "issuedCode": "292-000",
    "issuedNameRu": "ОВД РФ",
    "issuedNameEng": "OVD RF"
  },
  "person": {
    "birthDate": "12.09.1982",
    "ru": {
      "lastName": "Иванов",
      "firstName": "Иван",
      "middleName": "Иванович",
      "sex": "М",
      "birthPlace": "Москва",
      "livingRegion": "Москва"
    },
    "eng": {
      "lastName": "Ivanov",
      "firstName": "Ivan",
      "middleName": "Ivanovich",
      "sex": "М",
      "birthPlace": "Moscow",
      "livingRegion": "Moscow"
    },
    "expirationDate": null,
    "driverClass": null
  }
}

Response parameters

Name Data type Description
docType string Document type: SNILS, PASSPORT_RF, DRIVING_LICENSE, INTERNATIONAL_PASSPORT, INTERNATIONAL_PASSPORT_BIOMETRIC, OTHER
license object Document data
person object Document holder data

Document object (license)

Name Data type Description
series string Series
number string Number
issuedDate string Date of issue
issuedCode string Issuing department code
issuedNameRu string Issuing authority name (Russian)
issuedNameEng string Issuing authority name (English)

Holder object (person)

Name Data type Description
birthDate string Date of birth
expirationDate string Expiration date
driverClass string Driving license category
ru object Full name and data in Russian
eng object Full name and data in English

Personal data object (ru / eng)

Name Data type Description
lastName string Last name
firstName string First name
middleName string Middle name (patronymic)
sex string Sex
birthPlace string Place of birth
livingRegion string Region of residence