Получение статистики "Месяцы"
Метод API предназначен для получения статистики самозанятых за выбранный месяц.
Для вызова метода необходимо передать X-Login и X-Password в Headers запроса, в query параметрах указать дату начала выборки.
Для удобства поиска можно использовать дополнительный query параметр "Дата крайнего дня".
Запрос
Метод: GET https://business.selfwork.ru/selfemployed/business/v1/statistics/month
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/month?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
- 401: Unauthorized
- 500: Internal Server Error
Запрос выполнен успешно
{
"months": [
{
"date": "01.01.2021",
"expenses": 12345,
"payout": 12345,
"tax": 12345
}
],
"totalExpenses": 12345,
"totalPayouts": 12345,
"totalTax": 12345
}
Описание ответа:
| Ключ | Тип | Описание |
|---|---|---|
| months | array[object] | Массив со статистикой по месяцам |
| totalExpenses | int32 | Общая сумма расходов за указанный период |
| totalPayouts | int32 | Общая сумма выплат за указанный период |
| totalTax | int32 | Общая сумма налога за указанный период |
months:
| Ключ | Тип | Описание |
|---|---|---|
| date | string | Дата |
| expenses | int32 | Сумма расходов |
| payout | int32 | Сумма выплаты |
| tax | int32 | Налог |
Не валидные авторизационные данные
{
"errorCode": 1,
"message": "Access denied"
}
Системная ошибка
{
"errorCode": 100,
"message": "Internal server error"
}
Описание ошибки:
| Ключ | Описание |
|---|---|
| errorCode | Код ошибки, вернувшийся с сервера |
| message | Сообщение сервера, описывающее ошибку |