Skip to content

SNILS Validation

Validates the insured person's full name (last name, first name, and patronymic, if any), date of birth, sex, and SNILS against the records of the mandatory pension insurance system.

URL

Method: POST

  • Production: https://api.baas.kvell.group/v1/smev4/sfr/snils-validation
  • Stage: https://api.baas.stage.kvell.group/v1/smev4/sfr/snils-validation

Request body parameters

Name Data type Required Description
last_name string (max 100 characters) Yes Last name
first_name string (max 100 characters) Yes First name
middle_name string (max 100 characters) Yes, if present Middle name (patronymic)
birth_date string (format YYYY-MM-DD) Yes Date of birth
snils string (11 digits) Yes SNILS 
{
  "last_name": "Петина",
  "first_name": "Елена",
  "middle_name": "Владимировна",
  "birth_date": "1966-09-12",
  "snils": "02773319862"
}

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 — processing result
    • not found — no match found (full name, SNILS, and/or date of birth don't match each other)
    • true — SNILS is valid/current
    • false — SNILS is invalid/revoked

{
  "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