Skip to main content

Identification request

Check method​

You should use this method to send a beneficiary questionnaire to Bank 131 for identification.

Request v 2.0 allows you to send profiles of individuals, residents and non-residents of the Russian Federation, for verification. Request v 1.1 allows you to submit profiles only for residents of the Russian Federation for verification.

The response includes the request ID by which you can learn the verification result.

Endpoint​

For testing​

POST https://kyc-stage.bank131.ru/api/v2.0/check

When testing, no real ID verificatrion is performed, and answer will be emulated. Do not take these results to verify your customers' IDs.

For live testing​

POST https://kyc.bank131.ru/api/v2.0/check

Request​

Non-resident individuals can sign their requests using RSA Keys (example). To enable this functionality, contact your manager in Bank 131.

Request parameters (recipient details)​

NameMandatoryTypeDescription
type+stringRecipient type. Possible values:
FL_RESIDENT - resident individial;
FL_NONRESIDENT - non-resident individual
last_name+stringLast name
first_name+stringFirst Name
patronymic-stringPatronymic name (if any)
birthday+stringDate of Birth as DD.MM.YYYY. Must be 18 years old or older
birthplace+stringPlace of Birth
citizenship+stringCitizenship in ISO 3166-1 alpha-2 format
inn+stringTaxpayer Identification Number (INN in Russia), 6 to 14 characters
phone_number+stringPhone number (any format)
e-mail+stringValid email address
documents+arrayMandatory documents. The set of mandatory documents may vary depending on the beneficiary type and their citizenship according to the following rules:
for individuals residents of the Russian Federation - only a Russian passport PASSPORT_RF is required;
for individuals non-residents of the Russian Federation - a foreign passport FOREIGN_PASSPORT and any other type of document other than the Russian passport PASSPORT_RF is required;
for citizens of the Republic of Belarus - only a foreign passport FOREIGN_PASSPORT is required
 type+stringDocument type. Possible values:
PASSPORT_RF — Russian passport;
FOREIGN_PASSPORT — non-Russian passport;
MIGRATION_CARD - migration card;
RESIDENT_CARD — resident card;
REFUGEE_CERTIFICATE — refugee certificate;
VISA — visa;
ARRIVAL_NOTICE — arrival notice;
TEMPORARY_RESIDENCE_PERMIT — temporary residence permit;
PATENT — patent
 issuer_code- (Mandatory only for PASSPORT_RF)stringIssuing dicision code
 issuer+stringIssuing division
 issuer_date+stringIssuing date as DD.MM.YYYY
postcode-stringZIP Code
address+stringAddress
agent_contract_number+stringAgency Agreement No.
agent_contract_date+stringAgency Agreement Date
beneficial_owners+stringAlways: No BO
public_officials+stringAlways No

Request example​

curl -X POST 'https://kyc.bank131.ru/api/v2.0/check/' \
   -H 'x-partner-project: test-partner-project' \
   -H 'Content-Type: application/json' \
   -H 'accept: application/json' \
   --data-binary
   '{
   "payload":{
      "type":"FL_RESIDENT",
      "last_name":"Dmitriev",
      "first_name":"Ivan",
      "patronymic":"Ivanovich",
      "birthday":"01.01.1970",
      "birthplace":"Novgorod",
      "citizenship":"RU",
      "inn":"065553161159",
      "phone_number":"+79000000000",
      "email":"name@email.com",
      "documents":[
         {
            "type":"PASSPORT_RF ",
            "number":"0234567890",
            "issuer":"UFMS Russia",
            "issuer_date":"01.01.2010",
            "issuer_code":"123-000"
         }
      ],
      "address":"Novgorod, Pribrezhnaya str., 53",
      "postcode":"365826",
      "agent_contract_number":"123456789-0",
      "agent_contract_date":"01.01.2020",
      "beneficial_owners":"No BO",
      "public_officials":"No"
   },
       "signature":"dkQzYwTExRc0RFWk1CY0dBMVVFQnd3UTBMTXVJTkNjMEw3Ug0NCmd..."}' --compressed

Response​

For testing, the value of the status field sent in the response strictly depends on the last digit in ID number of the passport_number field sent in the request.

Last digit of passport_number fieldstatus field value
Even, including 0ok
Unevenerror

Response parameters​

NameMandatoryTypeDescription
status+stringIdentification status. Possible options: ok, error
data-DataResponse details object
id-numberCheck request ID
description-stringRequest status description
error-ErrorError details object
code+stringError code
description+stringError description
Successful response example​
    {
        "status": "ok",
        "data":
            {
                "id": "7",
                "description": "request added to queue"
               }
    }
Example of a response with an error​
    {
        "status": "error",
        "error": {
            "code": "partner_project_not_found",
            "description": "partner project not found"
        }
    }