Providing an Individual's INN

This method is used to send a request for providing an individual's INN based on their full passport data.

The following request headers must be passed in all requests:

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

The signature is generated using secret_key — the secret key found in the merchant's shop settings.

Request for providing an individual's INN

Method: POST

• Production: https://api.baas.kvell.group/v1/smev3/fns/inn-singular
• Stage: https://api.baas.stage.kvell.group/v1/smev3/fns/inn-singular

Request parameters (JSON)

Name	Data type	Required	Description
id_request	string (up to 36 characters)	No	End-to-end request identifier
last_name	string (up to 60 characters)	Yes	Last name
first_name	string (up to 60 characters)	Yes	First name
middle_name	string (up to 60 characters)	Yes, if present	Middle name
birth_date	string (YYYY-MM-DD format)	Yes	Date of birth
birth_place	string (up to 255 characters)	No	Place of birth
seriya	string (4 digits)	Yes	Russian passport series
number	string (6 digits)	Yes	Russian passport number
issue_date	string (YYYY-MM-DD format)	No	Issue date
issuer_code	string (\d{3}-\d{3} or \d{6} format)	No	Issuing department code
issuer_name	string (up to 255 characters)	No	Name of the authority that issued the document

Do not transliterate personal data

Enter the personal details exactly as recorded in the identity document; do not translate or transliterate them unless the API explicitly requires it.

{
  "id_request": "AC439881-E925-771B-E040-A8C062C84DEE",
  "last_name": "ЧАХЛОВ",
  "first_name": "ПЕТР",
  "middle_name": "АЛЕКСЕЕВИЧ",
  "birth_date": "1954-07-12",
  "birth_place": "РОССИЯ,,ГОРЬКОВСКАЯ ОБЛ.,АРЗАМАССКИЙ Р-Н,,НИКОЛЬСКОЕ С., ,,,",
  "seriya": "2202",
  "number": "919928",
  "issue_date": "2002-11-16",
  "issuer_code": "450-021",
  "issuer_name": "АРОВД"
}

Building the signature

The X-Signature signature is generated by concatenating X-Api-Key, json <request body>, and secret_key. A sha256 hash is computed from the resulting string:

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

Request response

{
  "request_id": "eddc16e3-abae-4981-87ab-5c320e263ab4"
}

request_id — request identifier, used to retrieve the result.

Retrieving the result of providing an individual's INN

Method: GET

• Production: https://api.baas.kvell.group/v1/smev3/fns/inn-singular/{request_id}
• Stage: https://api.baas.stage.kvell.group/v1/smev3/fns/inn-singular/{request_id}

URL request parameters

Name	Data type	Required	Description
request_id	string	Yes	Request identifier

GET /v1/smev3/fns/inn-singular/eddc16e3-abae-4981-87ab-5c320e263ab4

Building the signature

The X-Signature signature is generated by concatenating X-Api-Key, request_id, and secret_key. A sha256 hash is computed from the resulting string:

sha256({x-api-key}{request_id}{secret_key})

Request response

Example 1Example 2Example 3Example 4Example 5 (HTTP 404)

{
  "state": "in_progress",
  "request_id": "befe8815-24b0-446b-925c-ea128f39667c",
  "response_id": null
}

{
  "state": "finished",
  "request_id": "befe8815-24b0-446b-925c-ea128f39667c",
  "response_id": "df65dc1c-fc66-41cd-abbd-87218127fbeb",
  "result":
  {
    "status": "not_found"
  }
}

{
  "state": "finished",
  "request_id": "befe8815-24b0-446b-925c-ea128f39667c",
  "response_id": "df65dc1c-fc66-41cd-abbd-87218127fbeb",
  "result":
  {
    "status": "found",
    "inn": "520205004556"
  }
}

{
  "state": "finished",
  "request_id": "6ed9f77b-c150-4cdb-adcf-9d70d167f6ab",
  "response_id": null,
  "error": {
    "code": "internal",
    "desc": "Error connecting to SMEV"
  }
}

{
  "error": "request not found"
}

• state — request status
  • in_progress — being processed
  • finished — completed
• request_id — request identifier assigned for SMEV3 (optional)
• response_id — response identifier in the SMEV3 system, if a response was received from the department's information system (FNS)
• result — processing result (required if state = finished and error = null)
  • status — search result
    • not_found — INN not found
    • found — INN found
  • inn — individual's INN
• error — error from the internal service, SMEV, or the department's information system (required if state = finished and result = null)
  • code — error code (required)
  • desc — error description (required)
  • status_code — SMEV3 status HTTP code (optional)
  • destname — request field containing the error from SMEV (optional)