{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"571c3984-057f-4147-835e-483d8df8ac6b","name":"HROne APIs","description":"**HROne** is a comprehensive, cloud-based Human Resource Management System (HRMS) designed to streamline and automate HR operations. The **HROne APIs** enable secure and seamless data exchange — allowing external systems to integrate with HROne for employee management, payroll, attendance, leave, recruitment, and more.\n\n---\n\n## 🔐 Authentication\n\nAll API requests require the following headers:\n\n| Header | Description |\n|--------|-------------|\n| `API-Key` | Your unique API key. Use the `{{APIKey}}` variable. |\n| `domainCode` | Your organization's domain code. Use the `{{DomainCode}}` variable. |\n| `Content-Type` | Always `application/json` (auto-injected via pre-request script). |\n\n> **Note:** A collection-level pre-request script automatically injects the `Content-Type: application/json` header on every request.\n\n---\n\n## 🌐 Base URL\n\nAll endpoints use the `{{BaseURL}}` environment variable as the base URL. Set this in your active environment (e.g., `https://openapi.hrone.cloud/api`).\n\n---\n\n## 📁 Collection Structure\n\nThe collection is organized into the following folders:\n\n| Folder | Description |\n|--------|-------------|\n| **Employee** | APIs for managing employee profiles, bank details, education, insurance, resignation, confirmation, and more |\n| **Upcoming Join** | APIs for onboarding upcoming employees — add, update, and manage pre-joining data |\n| **Recruitment** | APIs for candidate management, job openings, document handling, and referrals |\n| **Attendance** | APIs for biometric data push, attendance calendar, shift management, and bulk status updates |\n| **Leave** | APIs for leave requests, leave balance, restricted holidays, and short leave reports |\n| **Payroll** | APIs for salary structure, CTC, statutory details, reimbursements, investments, and tax regime |\n| **LogOnUser** | APIs for fetching logged-in user details |\n| **File** | APIs for uploading files and Base64 encoded documents |\n| **Upcoming Event** | APIs for managing upcoming HR events |\n| **Document** | APIs for document upload and management |\n\n---\n\n## 📌 Common Request Patterns\n\nMost POST endpoints accept a JSON body with optional filters such as:\n- `employeeCode` — filter by specific employee(s)\n- `company`, `businessUnit`, `department`, `designation`, `grade`, `branch`, `region` — organizational filters\n- `createdDate` / `updatedDate` — date range filters with `fromDate` and `toDate`\n- `pagination` — control result size with `pageNumber` and `pageSize`\n\n---\n\n## ✅ Response Format\n\nSuccessful responses return HTTP `200 OK` with a JSON body. Common response fields include:\n- `statusCode` — API-level status code\n- `message` — human-readable status message\n- `data` — the actual response payload (array or object)\n\n---\n\n## 📝 Documentation Status\n\nThis collection contains **132 requests** across 10 folders. **50 requests** have full documentation. The remaining **82 requests** are being progressively documented. Requests with no description are identified and queued for documentation updates.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"49694603","team":11224707,"collectionId":"571c3984-057f-4147-835e-483d8df8ac6b","publishedId":"2sB3WnxhVs","public":true,"publicUrl":"https://apidocs.hrone.cloud","privateUrl":"https://go.postman.co/documentation/49694603-571c3984-057f-4147-835e-483d8df8ac6b","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.1","publishDate":"2026-04-30T06:04:34.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[{"name":"ExternalAPI","id":"d8756d6f-9961-44b2-8c35-320734e8a5dd","owner":"49694603","values":[{"key":"BaseURL","value":"https://openapi.hrone.cloud/api","enabled":true,"type":"default"},{"key":"APIKey","value":"2f4887ad9430e2c24dee26bd03c4318fe6f63a7b10e5503ff70c70ccacc2ebd5","enabled":true,"type":"text"},{"key":"SubscriptionKey","value":"8d03bffaed0342f697a393e3bb6de8d7","enabled":true,"type":"default"},{"key":"DomainCode","value":"inttest","enabled":true,"type":"default"},{"key":"company","value":"HROne Technologies ltd","enabled":true,"type":"default"},{"key":"businessUnit","value":"MNC","enabled":true,"type":"default"},{"key":"department","value":"Human Resources","enabled":true,"type":"default"},{"key":"subDepartment","value":"Talent management","enabled":true,"type":"default"},{"key":"designation","value":"Chief Human Resource Officer","enabled":true,"type":"default"},{"key":"region","value":"North","enabled":true,"type":"default"},{"key":"branch","value":"Delhi","enabled":true,"type":"default"},{"key":"subBranch","value":"Nariana","enabled":true,"type":"default"},{"key":"grade","value":"G1","enabled":true,"type":"default"},{"key":"level","value":"L1","enabled":true,"type":"default"},{"key":"reportingManager","value":"Abhay Kumar","enabled":true,"type":"default"},{"key":"functionalManager","value":"Ram Babu Paswan","enabled":true,"type":"default"},{"key":"EmployeeCode","value":"0357","enabled":true,"type":"default"},{"key":"baseUrl","value":"https://app.hrone.cloud/api","enabled":true,"type":"default"},{"key":"BearerToken","value":"Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJkb21haW5Db2RlIjoiaW50dGVzdCIsIklvVCI6IlciLCJ1bmlxdWVfbmFtZSI6Ijk5NTg1MDMwMDgiLCJjb21wYW55RG9tYWluQ29kZSI6ImludHRlc3QiLCJsb2dpblVzZXIiOiI5OTU4NTAzMDA4IiwiRW1wbG95ZWVJZCI6IjAiLCJVc2VyTG9nT25JZCI6Ijk5NTg1MDMwMDgiLCJQYXNzd29yZCI6IiIsIklzRmlyc3RUaW1lTG9nT24iOiIiLCJJc1RlbXBQYXNzd29yZCI6IkZhbHNlIiwiVXNlckxhbmd1YWdlIjoiMSIsIlVzZXJUaW1lWm9uZSI6IiIsIkxvZ09uSWQiOiIyIiwiVXNlck5hbWUiOiJQYW5rYWogQSBNYWxpayIsIkNsaWVudEJhc2VQYXRoIjoiaHR0cHM6Ly9hcHAuaHJvbmUuY2xvdWQiLCJDaGF0QXBwSWQiOiIiLCJHYXRld2F5Q3VzdG9tZXJDb2RlIjoiIiwiVWlkIjoiMzY0Njc5IiwiUmVmcmVzaEV4cGlyeSI6IjAiLCJFbWFpbElkIjoiIiwiTW9iaWxlTm8iOiIiLCJJc01mYUFjdGl2ZSI6Ik4iLCJCcm93c2VySWQiOiIiLCJEZXZpY2VUeXBlIjoiIiwiTG9nT25UeXBlIjoiMSIsIklzQXV0aGVudGljYXRlIjoiVHJ1ZSIsIk1lc3NhZ2UiOiIiLCJEb21haW5Db2RlIjoiaW50dGVzdCIsIkNvbXBhbnlEb21haW5Db2RlIjoiIiwiU2luZ2xlU2lnbk9uSWQiOiIiLCJJbnN0YW5jZUlkIjoiMTc4OTI0MzEiLCJuYmYiOjE3NTM3ODI2NzIsImV4cCI6MTc1Mzk5ODY3MiwiaXNzIjoiaHR0cHM6Ly9ocm9uZWF1dGhhcGkuaHJvbmUuY2xvdWQvIiwiYXVkIjoiMDk5MTUzYzI2MjU5NDliYzhlY2IzZTg1ZTAzZjU2MjMifQ.SS_PaYLplUxdyWY-nHGhHu4bbNT7sxd5nctVyNwD9Mk9OkSE1DSr7vgiR0AfUqcyYhV692Nz3drB_6ROe5S6DYpN3hf5sAmY0dJn5f9HaB6I5ig61ya1D7qCnqSwUFpuib1x04KAn9YNdMzPLyEMisJzZvQtsRs_Fdx933skMsEgkXlr9NdS1twgcA4CKnyZ-Z7nXLeoGFei8oEQArnFwzxQYRiAIzBzPBg7Mq5_U1IcGE4VqWaTzb1_1tu9gOakJfc_pWAsRL8nM0A0ry3vgAP0gFwcbsibl7VXHx8KfQxqik_CAb4FmNPy2i-Pzpi__x3WBKjYblxS8bauFg0xHw","enabled":true,"type":"default"},{"key":"UserId","value":"0357","enabled":true,"type":"default"}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/fa277144595a0987c7328ca991c3b1696573e86d99ff6c42aa000cdc2bbe1980","favicon":"https://res.cloudinary.com/postman/image/upload/v1767959398/team/60c96fc88bf72570795a7d29f8f5b1c2.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"ExternalAPI","value":"49694603-d8756d6f-9961-44b2-8c35-320734e8a5dd"}],"canonicalUrl":"https://apidocs.hrone.cloud/view/metadata/2sB3WnxhVs"}