# tipee

## Docs

- [Authentication](https://api.tipee.ch/getting-started/authentication.md)
- [Changelog notifications](https://api.tipee.ch/getting-started/changelog-notifications.md)
- [Error Handling](https://api.tipee.ch/getting-started/error-handling.md)
- [First steps](https://api.tipee.ch/getting-started/introduction.md)
- [OpenAPI Specifications](https://api.tipee.ch/getting-started/openapi-specs-25.09.01.md)
- [Rate limiting](https://api.tipee.ch/getting-started/rate-limiting.md)
- [Reporting an issue](https://api.tipee.ch/getting-started/reporting-an-issue.md)
- [Versioning](https://api.tipee.ch/getting-started/versioning.md)
- [List kinds](https://api.tipee.ch/versions/25.09.01/directory/list-kinds.md): Retrieves all kinds of possible resources. Only 'employee' is available at the moment.<br />Use 'api/directory/kinds.show' to get kind details including attributes.
- [List resources](https://api.tipee.ch/versions/25.09.01/directory/list-resources.md): Retrieves all resources of a specific kind, including those with no (or only past) sector contracts.<br />Returns associated details related to that kind. Only "employee" kind is available at the moment.<br />If you do not specify a date, today's date will be used.<br />Use the 'resource.team' filte…
- [List tags](https://api.tipee.ch/versions/25.09.01/directory/list-tags.md): Retrieves all tags that can describe actions in tipee (e.g. timechecks, activities, etc.).<br />Several filters can be used to narrow down the search.
- [List teams](https://api.tipee.ch/versions/25.09.01/directory/list-teams.md): Teams represents either the instance, a site or a sector
- [Show kind](https://api.tipee.ch/versions/25.09.01/directory/show-kind.md): Retrieves a specific kind with its attributes.<br />Regarding attributes, while using 'api/directory/resources.list', 'searchable' refers to whether you can apply a<br />filter to it or not (according to the filter type) and 'sortable' refers to 'orders'.
- [List absence types](https://api.tipee.ch/versions/25.09.01/schedule/list-absence-types.md): Retrieves all absence types (or the ones corresponding to the provided ids) with details about their statuses.
- [List absences](https://api.tipee.ch/versions/25.09.01/schedule/list-absences.md): Retrieves absences details about specific persons within a date range.<br />time_range will have a value if the absence does not cover the whole day.
- [List schedule templates](https://api.tipee.ch/versions/25.09.01/schedule/list-schedule-templates.md): Retrieves all schedule templates (or the ones corresponding to the provided ids).<br />If the team filter is used, it will return only schedule templates that are associated with the given teams (ignoring provided ids that are not).
- [List schedules](https://api.tipee.ch/versions/25.09.01/schedule/list-schedules.md): Retrieves all schedules (or the ones corresponding to the provided ids) within a date range.<br />If the resources filter is used, it will return only schedules that are associated with the given resources, ignoring provided ids that are not.
- [List timechecks](https://api.tipee.ch/versions/25.09.01/timeclock/list-timechecks.md): Retrieves all timecheck details (or the ones corresponding to the provided ids).<br />Several filters can be used to narrow down the search.<br />We do not recommend using legacy_id as it will soon be deprecated.

## OpenAPI Specs

- [preview](https://api.tipee.ch/openapi/preview.json)
- [25.09.01](https://api.tipee.ch/openapi/25.09.01.json)
- [24.06.10](https://api.tipee.ch/openapi/24.06.10.json)
- [24.02.01](https://api.tipee.ch/openapi/24.02.01.json)
- [24.01.01](https://api.tipee.ch/openapi/24.01.01.json)
- [20240101](https://api.tipee.ch/openapi/20240101.json)
- [20240201](https://api.tipee.ch/openapi/20240201.json)