RESTful Design
Clean, predictable REST endpoints with standard HTTP methods and JSON responses.
Secure by Default
Enterprise-grade security with JWT authentication, rate limiting, and encryption.
Versioned API
Stable API versions ensure your integrations keep working as we improve.
Authentication
All API requests require authentication using JWT tokens in the Authorization header. You can generate API keys from your dashboard settings.
Authorization: Bearer YOUR_API_KEY
Base URL
All API endpoints are relative to the base URL. We recommend using the HTTPS protocol for all requests.
https://api.zamansync.io/v1
Core Endpoints
POST
/auth/loginPOST
/shift-events/clock-inGET
/timesheetsGET
/reports/hoursclock-in.js
// Clock in an employee
const response = await fetch('https://api.zamansync.io/v1/shift-events/clock-in', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
locationId: "loc_123456789",
timestamp: new Date().toISOString(),
latitude: 37.7749,
longitude: -122.4194,
accuracy: 10
})
});
const data = await response.json();
console.log(data);Response
200 OK
{
"success": true,
"data": {
"shiftEventId": "evt_987654321",
"timestamp": "2025-10-17T09:00:00Z",
"status": "CLOCKED_IN",
"geofenceValid": true,
"location": {
"id": "loc_123456789",
"name": "Main Office"
}
}
}Official SDKs
Get started quickly with our official client libraries for your favorite languages.
Node.js
npm install @zamansync/sdk
Python
pip install zamansync
Ruby
gem install zamansync