Получение статистики "Группы самозанятых"

Метод API предназначен для получения статистики самозанятых объединённых в группу по виду деятельности.

Для вызова метода необходимо передать X-Login и X-Password в Headers запроса, в query параметрах указать дату начала выборки.

Для удобства поиска можно использовать дополнительный query параметр "Дата крайнего дня".

Запрос

Метод: GET https://business.selfwork.ru/selfemployed/business/v1/statistics/group

Query Parameters

Параметр	Тип	Обязательный	Описание
dateBegin	string	Да	Дата начала выборки. Пример: dd-MM-yyyy
dateEnd	string	Нет	Дата крайнего дня. Пример: dd-MM-yyyy

Headers

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

Пример

cURL

curl -X GET "https://business.selfwork.ru/selfemployed/business/v1/statistics/group?dateBegin=01-01-2025&dateEnd=07-09-2025" \
  -H "X-Login: your_login_here" \
  -H "X-Password: your_password_here" \
  -H "Content-Type: application/json"

Ответы

200: OK

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

{
  "groups": [
    {
      "date": "01.01.2021",
      "groupName": "Группа СЗ",
      "expenses": 12345,
      "payout": 12345,
      "tax": 12345
    }
  ],
  "totalExpenses": 12345,
  "totalPayouts": 12345,
  "totalTax": 12345
}

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

Ключ	Тип	Описание
groups	array[object]	Массив со статистикой по группам
totalExpenses	int32	Общая сумма расходов за указанный период
totalPayouts	int32	Общая сумма выплат за указанный период
totalTax	int32	Общая сумма налога за указанный период

groups:

Ключ	Тип	Описание
date	string	Дата
groupName	string	Наименование группы
expenses	int32	Сумма расходов
payout	int32	Сумма выплаты
tax	int32	Налог

401: Unauthorized

Не валидные авторизационные данные

{
  "errorCode": 1,
  "message": "Access denied"
}

500: Internal Server Error

Системная ошибка

{
  "errorCode": 100,
  "message": "Internal server error"
}

Описание ошибки:

Ключ	Описание
errorCode	Код ошибки, вернувшийся с сервера
message	Сообщение сервера, описывающее ошибку