API

OpenAPI

Machine-readable OpenAPI 3.1 description for Curio Time Public API v1.

The public OpenAPI 3.1 description includes authentication, health, time-entry reads, schedule reads and partner punches.

Published endpoints

Operation Full URL
Login POST https://pro.curiotime.com/api/v1/auth/login
Refresh token POST https://pro.curiotime.com/api/v1/auth/refresh
Revoke refresh token POST https://pro.curiotime.com/api/v1/auth/revoke
Health GET https://pro.curiotime.com/api/v1/health
Time entries GET https://pro.curiotime.com/api/v1/companies/{companyId}/time-entries
Schedules GET https://pro.curiotime.com/api/v1/companies/{companyId}/schedules/shifts
Clock in / clock out POST https://pro.curiotime.com/api/v1/companies/{companyId}/punches

Clock in

curl -X POST \
  'https://pro.curiotime.com/api/v1/companies/{companyId}/punches' \
  -H 'Authorization: Bearer {accessToken}' \
  -H 'Content-Type: application/json' \
  -d '{"employeeId":"{employeeId}","action":"start"}'

Clock out

curl -X POST \
  'https://pro.curiotime.com/api/v1/companies/{companyId}/punches' \
  -H 'Authorization: Bearer {accessToken}' \
  -H 'Content-Type: application/json' \
  -d '{"employeeId":"{employeeId}","action":"stop"}'

See Clock in / clock out for roles, fields, responses and errors.

Download openapi.yaml

The server URL in the file is:

https://pro.curiotime.com/api/v1

Import the file into Swagger UI, Postman or your preferred OpenAPI client generator. Only operations in the published specification are part of the supported public API contract.