Skip to content

Passport Verification

The method is used to send a request to the Russian Ministry of Internal Affairs (MVD) to verify the validity of a Russian internal passport by its details.

URL

Method: POST

  • Production: https://api.baas.kvell.group/v1/smev4/gismu/rfp-check
  • Stage: https://api.baas.stage.kvell.group/v1/smev4/gismu/rfp-check

Request body parameters

Name Data type Required Description
seriya string Yes Passport series (4 digits)
number string Yes Passport number (6 digits)
last_name string Yes Last name (max 64 characters)
first_name string Yes First name (max 64 characters) 
{
  "seriya": "5869",
  "number": "002032",
  "last_name": "Иванов",
  "first_name": "Иван"
}

Request headers

Name Type Required Description
X-Api-Key string Yes Unique shop identifier
X-Signature string Yes Request signature

Building the signature

The X-Signature signature is built by concatenating X-Api-Key, json <request body>, and secret_key, then taking sha256 of the resulting string:

sha256({x-api-key}{json <request body>}{secret_key})

Request response

{
  "created_at": "string",
  "query_id": "string",
  "error": "string",
  "result": "string"
}
  • created_at — request time in SMEV4
  • query_id — request identifier in SMEV4
  • result — document status (string "Действительный" (valid), "Недействительный" (invalid), or "not found")

{
  "errors":
  [
    {
      "code": 0,
      "message": "Field required",
      "field": "last_name"
    }
  ]
}
  • code — error code
  • message — error text
  • field — name of the request field that failed validation

{
  "errors":
  [
    {
      "code": 45,
      "message": "SMEV unavailable"
    }
  ]
}
  • code — error code
  • message — error text