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.Employee EngagementSocial wall, praise, polls and surveys.Payroll SoftwarePreview, process and govern payroll.Leave ManagementPolicies, balances and approvals.Attendance ManagementDevices, shifts and monthly locks.Expense ManagementClaims, approvals and settlement.Recruitment SoftwareAI ATS: video interviews, job boards, CV↔JD.Performance ManagementOKRs, reviews, 1:1s, promotions, skills.Projects & TimesheetsPSA: time, resourcing, invoicing, FX, reports.Integrations & SSOSSO, SCIM, Slack, Teams, calendars, connectors.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.Recruitment APIList jobs and receive website applications with resumes.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.BlogSEO-ready HRMS, 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.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 Recruitment & Careers API
List open jobs and receive candidate applications (with resumes) from your own website — via a scoped REST API or a no-code hosted careers embed. Every application becomes an auto-screened candidate in the CozyHR ATS.
Last updated: · CozyHR editorial team
Developer documentation
REST
API style
Bearer
auth model
JSON
payloads
GET /api/public/v1/recruitment/jobs
POST /api/public/v1/recruitment/applications
Hosted careers embed /careers/{slug}
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 Recruitment & Careers API is a CozyHR.com resource for teams evaluating developer documentation in a modern HRMS. List open jobs and receive candidate applications (with resumes) from your own website — via a scoped REST API or a no-code hosted careers embed. Every application becomes an auto-screened candidate in the CozyHR ATS. It covers get /api/public/v1/recruitment/jobs, post /api/public/v1/recruitment/applications, hosted careers embed /careers/{slug} and explains how CozyHR connects list open jobs and receive applications and no-code hosted embed 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/recruitment/jobs
POST /api/public/v1/recruitment/applications
Hosted careers embed /careers/{slug}
Developer docs
List open jobs
Fetch your published roles to render them on your website. Authenticate with an API key carrying the recruitment.read scope (Authorization: Bearer <key>).
GET /api/public/v1/recruitment/jobs
scope recruitment.read
JSON: id, title, location, department, type, salary
Developer docs
Receive applications
Post a candidate application as multipart/form-data including the resume file. The resume is stored in your tenant storage, a candidate record is created in stage NEW, and it is auto-screened (resume parse + JD match). Requires the recruitment.write scope.
POST /api/public/v1/recruitment/applications
fields: jobId, candidateName, candidateEmail, candidatePhone, resumeFile
auto-screen: resume parse + CV/JD match
Developer docs
No-code hosted embed
Prefer no coding? Embed your tenant careers page directly with an iframe. CozyHR hosts the job list and apply form, rate-limited and spam-protected, feeding the same ATS pipeline.
<iframe src="/careers/{slug}">
GET /api/careers/{slug}/jobs
POST /api/careers/{slug}/apply
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 Recruitment & Careers API 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 Recruitment & Careers API?
CozyHR Recruitment & Careers API is a CozyHR.com resource for teams evaluating developer documentation in a modern HRMS. List open jobs and receive candidate applications (with resumes) from your own website — via a scoped REST API or a no-code hosted careers embed. Every application becomes an auto-screened candidate in the CozyHR ATS. It covers get /api/public/v1/recruitment/jobs, post /api/public/v1/recruitment/applications, hosted careers embed /careers/{slug} and explains how CozyHR connects list open jobs and receive applications and no-code hosted embed 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 Recruitment & Careers API?
CozyHR Recruitment & Careers API is useful for HR admins, payroll managers, operations leaders and tenant owners who want structured software for get /api/public/v1/recruitment/jobs.
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.