Use TotemClock inside another product, without forcing its interface.

One Swagger, automatic company context

Open the shared documentation and paste your company key into Authorize. Requests never accept a company identifier: the key determines the tenant.

Scoped, revocable credentials

Owners and administrators create keys from API e integrazioni. Choose read/write scopes, copy the secret once, then rotate or revoke it at any time.

Ready-to-run collection

Import every company endpoint with variables for the base URL, API key, employee and reporting period.

Server-side JavaScript client with types

Download a zero-dependency ESM client for every Company API v1 operation. It refuses browser execution, keeps the key in the X-API-Key header and never accepts an organizationId.

const client = createTotemClockCompanyClient({
  apiKey: process.env.TOTEMCLOCK_API_KEY
});
console.log(await client.organization());

Server-side Python client

Download a Python 3.9+ client for every Company API v1 operation. It uses only the standard library, keeps the secret in the X-API-Key header, requires HTTPS and rejects organizationId tenant selectors.

client = TotemClockCompanyClient(
    os.environ["TOTEMCLOCK_API_KEY"]
)
print(client.organization())

Executable payroll, ERP and HR workflows

Run a monthly payroll CSV export, a read-only HR snapshot or a guarded ERP punch example from Node.js. The ERP workflow is a dry run unless you explicitly set TOTEMCLOCK_CONFIRM_WRITE=CREATE_PUNCH, and it checks the employee against the company selected by the key before writing.

TOTEMCLOCK_MONTH=2026-09 node \
  totemclock-company-api-workflows.mjs \
  payroll-export > timecards.csv

Decimal hours

GET /api/tools/decimal-hours?time=07:30

Worked hours

GET /api/tools/worked-hours?start=08:30&end=17:30&breakMinutes=60

Worked shifts batch

GET /api/tools/worked-shifts-summary?shift=08:00,17:00,60&shift=22:00,06:30,30

Structured JSON batch

POST /api/tools/worked-shifts-summary

curl -X POST https://totemclock.com/api/tools/worked-shifts-summary \
  -H 'Content-Type: application/json' \
  -d '{"shifts":[{"start":"08:00","end":"17:00","breakMinutes":60}]}'

Timesheet and pre-payroll summary

GET /api/tools/timesheet-summary?entry=08:00&entry=07:30&regularMinutesLimit=900

Structured timesheet JSON

POST /api/tools/timesheet-summary

curl -X POST https://totemclock.com/api/tools/timesheet-summary \
  -H 'Content-Type: application/json' \
  -d '{"entries":["08:00","07:30"],"regularMinutesLimit":900}'

Spreadsheet-ready CSV

GET /api/tools/timesheet-summary/csv?entry=08:00&entry=07:30

Calendar-ready work shifts

POST /api/tools/worked-shifts-calendar.ics

curl -X POST https://totemclock.com/api/tools/worked-shifts-calendar.ics \
  -H 'Content-Type: application/json' \
  -d '{"shifts":[{"start":"2026-09-10T08:00:00+02:00","end":"2026-09-10T17:00:00+02:00","breakMinutes":60}]}' \
  -o totemclock-work-shifts.ics

JavaScript, TypeScript, Python and API clients

Import a zero-dependency ESM or Python client, including explicit GET and JSON methods for both batch summaries plus CSV and iCalendar exports. The installable npm-format archive includes the checked TypeScript declarations and is served directly here; it is not presented as an npm registry publication.

npm install https://totemclock.com/downloads/totemclock-time-tools-1.0.0.tgz