API docs by Redocly

Dochadzka.app - Stats API (1.0.0)

Download OpenAPI specification:Download

Webnotion s.r.o.: developers@webnotion.sk URL: https://www.webnotion.sk

OpenApi doc for Dochadzka.app Stats API

Provides daily planned/real worked hours per restaurant (Daily report) and employee birthdays (Birthday).

Changelog

version date change
v1.0.0 2026-07-21 - initial version: Daily report and Birthday endpoints.

Endpoints

Daily report

Returns planned and real worked hours per restaurant and day.

If no parameter is sent, data for yesterday are returned.

Validations/specifications:

  • date, from, to must be in YYYY-MM-DD format
  • from/to must be sent together
  • dates in the past are allowed (backfill of history)
  • restaurant/day combination without any plan/attendance data is not included in response
  • response is a snapshot of current attendance data - repeated call for the same day may return updated values (attendance corrections). Upsert on client side by (restaurant, date) is recommended.
Authorizations:
AuthToken
query Parameters
date
string <date>
Example: date=2026-07-07

Single day for which data will be returned. Optional. If no date parameter is sent, endpoint returns data for yesterday. Cannot be combined with from/to.

from
string <date>
Example: from=2026-07-01

Start of date interval (inclusive). Must be sent together with to. Cannot be combined with date.

to
string <date>
Example: to=2026-07-07

End of date interval (inclusive). Must be sent together with from. Cannot be combined with date.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    }
]

Birthday

Returns employees of specified restaurant who enabled birthday sharing, with their name and birth date.

Authorizations:
AuthToken
path Parameters
company
required
integer
Example: 1

ID of company.

restaurant
required
integer
Example: 12

ID of restaurant (must belong to specified company).

Responses

Response samples

Content type
application/json
{
  • "employees": [
    ]
}

DailyReport

restaurant
required
string^(SK|CZ)[0-9]{3}$

Code of restaurant (standardized McD code of restaurant, same across all systems).

date
required
string <date>

Business day date in YYYY-MM-DD format.

plan_hours
required
number or null <float>

Sum of planned hours of all employees of the restaurant for the day. Decimal point (327.5), not comma. Null if no shift plan exists for the day.

real_hours
required
number or null <float>

Sum of real worked hours of all employees of the restaurant for the day. Decimal point, not comma. Null if no attendance data exists for the day.

{
  • "restaurant": "SK043",
  • "date": "2026-07-07",
  • "plan_hours": 357,
  • "real_hours": 327.5
}

BirthdayEmployee

id
required
integer

Unique ID of employee.

name
required
string

Full name of employee.

birthday
required
string

Birth date of employee in DD/MM/YYYY format.

{
  • "id": 1234,
  • "name": "John Doe",
  • "birthday": "31/12/1990"
}