Developer-Ready API

Build Custom Integrations with the Attendance API

Connect Clokio to your ERP, payroll, and HR systems with a clean REST API. Clock employees in and out programmatically, export attendance data, and build custom workflows.

# Clock in an employee
curl -X POST \
https://app.clokio.io/api/attendance/clock-in \
-H "Authorization: Bearer TOKEN" \
-H "Content-Type: application/json" \
-d '{
"latitude": 32.0853,
"longitude": 34.7818
}'
# Response
{
"status": "success",
"message": "Clocked in",
"data": {
"id": 1234,
"clock_in": "2025-02-06T09:00:00Z",
"verified": true
}
}

API Overview

A clean, RESTful API designed for easy integration.

Authentication

Bearer token authentication via Laravel Sanctum. Secure, stateless, and easy to integrate with any platform.

Clock-In / Clock-Out

Programmatic clock-in and clock-out endpoints with GPS coordinates, biometric flags, and custom metadata support.

Employee Management

CRUD operations for employees, departments, and work locations. Sync your HR system with Clokio automatically.

Leave Requests

Create, approve, and manage leave requests programmatically. Query quotas, balances, and leave history.

Reports & Exports

Pull attendance summaries, export to Excel, and generate payroll-ready data filtered by date range, department, or employee.

Multi-Tenant

All endpoints are organization-scoped via the X-Organization-Code header. Manage multiple organizations from one integration.

Integration Use Cases

Common ways developers use the Clokio API.

ERP Integration

Sync attendance records with SAP, Oracle, or custom ERP systems. Pull clock-in data on a schedule or in real time.

Payroll Sync

Feed verified attendance hours directly into payroll software. Calculate overtime, late arrivals, and early departures automatically.

Kiosk Clock-In

Build a shared tablet kiosk for clock-in at office entrances using the API. Employees scan a badge or enter an ID to clock in.

Custom Dashboards

Pull attendance data into your own BI tools, Grafana, or custom admin panels. Visualize trends and spot patterns.

Biometric Terminal

Connect hardware biometric terminals to Clokio via the API. Use existing fingerprint or face recognition hardware with Clokio's backend.

Slack / Teams Bot

Build a chat bot that lets employees clock in from Slack or Microsoft Teams. Query attendance status via chat commands.

Quick Start

Get up and running in minutes with these examples.

1. Authenticate and get a token

curl -X POST https://app.clokio.io/api/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "admin@yourcompany.com",
    "password": "your_password"
  }'

2. Clock in an employee

curl -X POST https://app.clokio.io/api/attendance/clock-in \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "X-Organization-Code: your-org-code" \
  -H "Content-Type: application/json" \
  -d '{
    "latitude": 32.0853,
    "longitude": 34.7818
  }'

3. Fetch attendance records

curl -X GET "https://app.clokio.io/api/attendance?date_from=2025-02-01&date_to=2025-02-28" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "X-Organization-Code: your-org-code"

Start Building with the Attendance API

Get your API key in seconds. Full API documentation available. Free for all developers during launch.