GETRead employees
curl -H "Authorization: Bearer ch_live_..." \
"https://cozyhr.com/api/public/v1/employees?status=ACTIVE&limit=50"Sync employee codes, names, emails, departments and locations into internal systems.
Menu
Products
HR SoftwareEmployee master and org setup.Employee Self ServicePortal for employees and managers.Mobile AppMobile-ready HR actions.Employee EngagementAnnouncements and workforce touchpoints.Payroll SoftwarePreview, process and govern payroll.Leave ManagementPolicies, balances and approvals.Attendance ManagementDevices, shifts and monthly locks.Expense ManagementClaims, approvals and settlement.Recruitment SoftwareCandidate handoff to onboarding.Performance ManagementGoals, reviews and feedback.MarketplaceDevices, APIs and partner systems.
Docs
Developer DocsQuickstart for API keys, scopes and endpoints.REST API ReferenceEmployees, attendance punches and JSON payloads.AuthenticationAPI keys, OAuth, scopes and rate limits.Employees APIRead tenant employee directory records.Attendance APIIngest biometric and middleware punches.WebhooksDelivery logs, retries and endpoint setup.REST API HR AutomationCase study for internal HR automation.Biometric Attendance SyncBlog guide for punch API rollouts.Payroll API GuidePlanning payroll-adjacent integrations.
Resources
What is HRMS?Meaning, modules and HRMS buying context.What is Payroll?Payroll process, deductions and controls.Statutory CompliancePF, ESI, PT, TDS and compliance basics.Leave Management GuidePolicies, balances and approval paths.Attendance Management GuidePunches, shifts, rosters and monthly locks.Performance Management GuideGoals, reviews and manager feedback.BlogHRMS, payroll and compliance articles.GuidesDeep implementation-ready explainers.TemplatesPolicies, forms and payroll checklists.EbooksLong-form HRMS planning resources.Holiday Lists 2026Calendar planning for teams and locations.Gender Inclusivity ReportInclusive HR operations and reporting.WebinarsLive product and HR operations sessions.PodcastsConversations with HR and payroll leaders.AcademyRole-wise CozyHR learning paths.CommunityPeer support for HR operators.Case StudiesCustomer rollout and payroll outcomes.Book a DemoSee CozyHR workflows with your use case.API Case StudyREST API automation proof story.Attendance API BlogBiometric middleware and punch API guide.
Compliance
PF ActConfigure this CozyHR workflow with clean records and guided admin controls.ESI ActConfigure this CozyHR workflow with clean records and guided admin controls.Factories ActConfigure this CozyHR workflow with clean records and guided admin controls.Maternity Benefit ActConfigure this CozyHR workflow with clean records and guided admin controls.Payment of Gratuity ActConfigure this CozyHR workflow with clean records and guided admin controls.Apprentices ActConfigure this CozyHR workflow with clean records and guided admin controls.Indian StatesConfigure this CozyHR workflow with clean records and guided admin controls.IndustriesConfigure this CozyHR workflow with clean records and guided admin controls.Payroll SoftwareConfigure this CozyHR workflow with clean records and guided admin controls.
Company
AboutConfigure this CozyHR workflow with clean records and guided admin controls.CustomersConfigure this CozyHR workflow with clean records and guided admin controls.CareersConfigure this CozyHR workflow with clean records and guided admin controls.Media KitConfigure this CozyHR workflow with clean records and guided admin controls.PartnersConfigure this CozyHR workflow with clean records and guided admin controls.Payroll Service ProvidersConfigure this CozyHR workflow with clean records and guided admin controls.ContactConfigure this CozyHR workflow with clean records and guided admin controls.BengaluruConfigure this CozyHR workflow with clean records and guided admin controls.ChennaiConfigure this CozyHR workflow with clean records and guided admin controls.DelhiConfigure this CozyHR workflow with clean records and guided admin controls.HyderabadConfigure this CozyHR workflow with clean records and guided admin controls.MumbaiConfigure this CozyHR workflow with clean records and guided admin controls.PuneConfigure this CozyHR workflow with clean records and guided admin controls.DubaiConfigure this CozyHR workflow with clean records and guided admin controls.
Support
Online SupportConfigure this CozyHR workflow with clean records and guided admin controls.Payroll System SupportConfigure this CozyHR workflow with clean records and guided admin controls.Mobile App SupportConfigure this CozyHR workflow with clean records and guided admin controls.Leave SupportConfigure this CozyHR workflow with clean records and guided admin controls.ESS SupportConfigure this CozyHR workflow with clean records and guided admin controls.Attendance SupportConfigure this CozyHR workflow with clean records and guided admin controls.Implementation ServicesConfigure this CozyHR workflow with clean records and guided admin controls.
Developer docsREST API
CozyHR REST API Reference
REST API reference for CozyHR employees, attendance punches, authentication headers, rate limits and JSON payloads.
Last updated: · CozyHR editorial team
Developer documentation
REST
API style
Bearer
auth model
JSON
payloads
GET /api/public/v1/employees
POST /api/public/v1/attendance/punches
Bearer token authentication
API quickstart
Start with a scoped Bearer token
CozyHR public APIs are tenant-scoped. Create a key in the developer console, pass it as a Bearer token and keep secrets out of browser code.
POSTIngest attendance punches
curl -H "Authorization: Bearer ch_live_..." \
-H "Content-Type: application/json" \
-d '{"employeeCode":"CH-001","punchType":"IN"}' \
"https://cozyhr.com/api/public/v1/attendance/punches"Send biometric or middleware IN/OUT punches while keeping raw logs available for recalculation.
POSTIssue OAuth token
curl -H "Authorization: Bearer ch_live_..." \
-H "Content-Type: application/json" \
-d '{"employeeCode":"CH-001","punchType":"IN"}' \
"https://cozyhr.com/api/oauth/token"Use client credentials when a backend integration needs scoped, revocable API access.
SEO answer block
What this CozyHR page covers
CozyHR REST API Reference is a CozyHR.com resource for teams evaluating developer documentation in a modern HRMS. REST API reference for CozyHR employees, attendance punches, authentication headers, rate limits and JSON payloads. It covers get /api/public/v1/employees, post /api/public/v1/attendance/punches, bearer token authentication and explains how CozyHR connects authentication and core endpoints with employee records, attendance, payroll, compliance workflows and Super Admin controls. The page is written for HR admins, payroll managers, founders and operations teams who need practical software context rather than a thin brochure page.
GET /api/public/v1/employees
POST /api/public/v1/attendance/punches
Bearer token authentication
Developer docs
Authentication
Send a CozyHR API key or OAuth bearer token in the Authorization header. Every request is tenant-scoped and rate limited.
Authorization: Bearer ch_live_...
Scoped API keys
Redis-backed rate limits
Developer docs
Core endpoints
Read employee directory records and ingest attendance punches from middleware, biometric agents or internal workforce tools.
GET employees
POST attendance punches
JSON responses
Implementation workflow
How teams implement this in CozyHR
A good HRMS page should explain the operational path, not only list features. The steps below show how this workflow moves from evaluation to daily use inside CozyHR.
1
Map the current process
Document how REST API Reference works today across HR, finance, managers and employees.
2
Configure CozyHR
Create the required company setup, employee fields, policies, approval paths and role access in CozyHR.
3
Import and validate data
Load employee records, device mappings, salary values, statutory IDs, documents and historical context.
4
Operate with audit trails
Run day-to-day workflows with database-backed records, review states, reports and Super Admin visibility.
Frequently asked questions
Questions HR teams ask before buying
These answers are written as plain, crawlable content for buyers and AI search systems. They keep the page useful even before someone opens the product.
What is CozyHR REST API Reference?
CozyHR REST API Reference is a CozyHR.com resource for teams evaluating developer documentation in a modern HRMS. REST API reference for CozyHR employees, attendance punches, authentication headers, rate limits and JSON payloads. It covers get /api/public/v1/employees, post /api/public/v1/attendance/punches, bearer token authentication and explains how CozyHR connects authentication and core endpoints with employee records, attendance, payroll, compliance workflows and Super Admin controls. The page is written for HR admins, payroll managers, founders and operations teams who need practical software context rather than a thin brochure page.
Who should use CozyHR REST API Reference?
CozyHR REST API Reference is useful for HR admins, payroll managers, operations leaders and tenant owners who want structured software for get /api/public/v1/employees.
How does CozyHR support this workflow?
CozyHR connects this page's workflow to employee master data, organization setup, attendance, payroll, approvals, reports and Super Admin configuration so the process stays governed end to end.
Can this be configured for Indian payroll and compliance?
Yes. CozyHR is designed with India-first HR and payroll context including PF, ESI, professional tax, TDS, employee documents, attendance devices, shift policies and payroll review workflows.
CozyHR next step
Open developer docs Build on the CozyHR REST API.
Create API keys in the developer console, test employee and attendance endpoints, then attach webhook delivery logs for production monitoring.