Перейти к основному содержимому
Версия: Latest

Получение списка самозанятых по ФИО

Метод API предназначен для получения списка самозанятых по ФИО.

Для успешного вызова метода необходимо передать X-Login и X-Password в Headers запроса и JSON-объект с ФИО самозанятых.

Запрос​

Метод: POST https://business.selfwork.ru/selfemployed/business/v2/self-employed/find-by-fio

Headers​

ПараметрТипОбязательныйОписание
X-LoginstringДаЛогин пользователя
X-PasswordstringДаПароль пользователя

Request Body​

ТипОбязательныйОписание
array[findIndividualByFioDtos]ДаМассив объектов с ФИО для поиска

findIndividualByFioDtos​

ПараметрТипОбязательныйОписание
firstNamestringДаИмя
lastNamestringДаФамилия
middleNamestringНетОтчество

Пример​

curl -X POST "https://business.selfwork.ru/selfemployed/business/v2/self-employed/find-by-fio" \
 -H "X-Login: your_login_here" \
 -H "X-Password: your_password_here" \
 -H "Content-Type: application/json" \
 -d '[
   {
     "firstName": "Иван",
     "lastName": "Петров",
     "middleName": "Сергеевич"
   },
   {
     "firstName": "Анна",
     "lastName": "Сидорова",
     "middleName": "Владимировна"
   },
   {
     "firstName": "Михаил",
     "lastName": "Коновалов"
   }
 ]'

Ответы​

Запрос выполнен успешно

[
  {
    "id": 10,
    "firstName": "Виктор",
    "lastName": "Иванов",
    "middleName": "Викторович",
    "birthDate": "1994-01-27T00:00:00.000+0000",
    "state": 3,
    "gender": "M",
    "bankCards": ["2222********5555", "2222********6666", "2222********7777"],
    "individualType": 0,
    "snils": "12345678901",
    "inn": "1234567890",
    "phone": "+79612345678",
    "groups": [{ "id": 10, "name": "Программист" }],
    "comment": "string",
    "autoPayTax": true
  }
]

Описание ответа:

КлючОписание
idИдентификатор в базе данных
firstNameИмя
lastNameФамилия
middleNameОтчество
birthDateДата рождения
stateСтатус
genderПол
bankCardsСписок банковских карт
individualTypeТип исполнителя: 0 - самозанятый; 1 - физ. лицо
snilsСНИЛС
innИНН
phoneНомер телефона в формате +7ХХХХХХХХХХ
groupsВиды деятельности: массив { id, name }
commentПроизвольная информация
autoPayTaxАвтоматическая выплата налогов

Справочник статусов (state)​

СтатусОписание
0Новый, не обработан
1В обработке
2Не самозанятый
3Самозанятый, не предоставил права площадке
4Самозанятый
5Согласие отозвано
6Архивный
7Не существует
8Блокирован
9Ожидает СНИЛС (для физ. лица)