Resources

Zeitstrom API v2 is organized by domain. Endpoints are scoped to your institution and follow standard REST patterns: GET / for lists, GET /{id}/ for details, and POST/PATCH/DELETE where write operations are supported.

Base URL

  • Base: https://api.zeitstrom.com/api/v2/ — all paths end with a trailing slash.
  • Auth: Authorization: Token <YOUR_API_TOKEN> (see Authentication)

Conventions

  • IDs: Resources are identified by a UUID string returned as id.
  • Filtering by IDs: Most endpoints accept ?ids={id}|{id}|....
  • Ordering: If supported by the endpoint, ?order=field|-field applies ordering; unsupported fields return a 400 with details under the $query key.
  • Pagination: Limit/offset with a count/next/previous/results envelope. Most endpoints default to a limit of 100 with a maximum of 1000; some endpoints (e.g. absences, physical tokens) use higher defaults or maximums — see the resource page for specifics.

Resource groups

Example

List employees

curl -G https://api.zeitstrom.com/api/v2/employees/employees/ \
  -H "Authorization: Token <YOUR_API_TOKEN>" \
  -d limit=100

Get a specific workday

curl https://api.zeitstrom.com/api/v2/timestamps/workdays/a3f8b2c1-4e5d-4a6b-9c7d-8e1f2a3b4c5d/ \
  -H "Authorization: Token <YOUR_API_TOKEN>"

Was this page helpful?