Перейти к содержанию

Получить ИНН

Необходимо согласие пользователя на получение информации о ИНН. В поле scope у токена должен присутствовать доступ вида opensme/individual/inn/get

AUTHORIZATIONS: httpAuth

Responses

200 ИНН

RESPONSE HEADERS

X-Request-Id (required) - string - Идентификатор запроса

RESPONSE SCHEMA: application/json

Parameters Type Description
inn string ^(\d{12})$ ИНН

Пример запроса

GET https://business.tinkoff.ru/openapi/api/v1/individual/documents/inn

Пример ответа

{
  "inn": "123456789876"
}

400 Некорректный запрос

RESPONSE HEADERS

X-Request-Id (required) - string - Идентификатор запроса

RESPONSE SCHEMA: application/json

Parameters Type Description
errorId (required) string Уникальный идентификатор ошибки
errorMessage (required) string Текст ошибки
errorCode (required) string Код ошибки
errorDetails (required) object Дополнительные данные об ошибке

Примеры ответа ошибкии 400:

Ошибка при неправильно заполненном ИНН 

{
  "errorId": "retw6789",
  "errorMessage": "Некорректно заполнен ИНН",
  "errorCode": "VALIDATION_ERROR"
}

Ошибка при неправильно переданном значении поля revenueTypeCode

{
  "errorId": "cde4zxc5",
  "errorMessage": "Ваш запрос невалиден",
  "errorCode": "INVALID_DATA",
  "errorDetails": {
    "revenueTypeCode": "expected revenueTypeCode to be within List(1, 2, 3), but was '0'"
  }
}

401 Ошибка аутентификации

RESPONSE HEADERS

X-Request-Id (required) - string - Идентификатор запроса

RESPONSE SCHEMA: application/json

Parameters Type Description
errorId (required) string Уникальный идентификатор ошибки
errorMessage (required) string Текст ошибки
errorCode (required) string Код ошибки

Примеры ответа ошибкии 401:

{
  "errorId": "asdq3412",
  "errorMessage": "Не хватает учетных данных",
  "errorCode": "UNAUTHORIZED"
}

403 Ошибка авторизации

RESPONSE HEADERS

X-Request-Id (required) - string - Идентификатор запроса

RESPONSE SCHEMA: application/json

Parameters Type Description
errorId (required) string Уникальный идентификатор ошибки
errorMessage (required) string Текст ошибки
errorCode (required) string Код ошибки

Примеры ответа ошибкии 403:

{
  "errorId": "rtbe4567",
  "errorMessage": "Неправильный Tls сертификат",
  "errorCode": "FORBIDDEN"
}

422 Ошибка при обработке данных

RESPONSE HEADERS

X-Request-Id (required) - string - Идентификатор запроса

RESPONSE SCHEMA: application/json

Parameters Type Description
errorId (required) string Уникальный идентификатор ошибки
errorMessage (required) string Текст ошибки
errorCode (required) string Код ошибки
errorDetails (required) object Дополнительные данные об ошибке

Примеры ответа ошибкии 422:

{
  "errorId": "bcde3412",
  "errorMessage": "На балансе недостаточно средств",
  "errorCode": "INSUFFICIENT_FUNDS"
}

429 Слишком много запросов

RESPONSE HEADERS

X-Request-Id (required) - string - Идентификатор запроса

RESPONSE SCHEMA: application/json

Parameters Type Description
errorId (required) string Уникальный идентификатор ошибки
errorMessage (required) string Текст ошибки
errorCode (required) string Код ошибки

Примеры ответа ошибкии 429:

{
"errorMessage": "Слишком много запросов. Попробуйте позже",
"errorCode": "TOO_MANY_REQUESTS",
"errorId": "acdf000"
}

500 Ошибка сервера

RESPONSE HEADERS

X-Request-Id (required) - string - Идентификатор запроса

RESPONSE SCHEMA: application/json

Parameters Type Description
errorId (required) string Уникальный идентификатор ошибки
errorMessage (required) string Текст ошибки
errorCode (required) string Код ошибки

Примеры ответа ошибкии 500:

{
  "errorId": "asdq3412",
  "errorMessage": "Непредвиденная ошибка. Пожалуйста, попробуйте позже",
  "errorCode": "INTERNAL_ERROR"
}