HRMPro · API Docs
← Home Login Register

HRMPro REST API

Programmatic access to all HR data — employees, attendance, payroll, leaves, recruitment and more. Token-based authentication via Laravel Sanctum.

Base URL: https://hrms.griomedglobal.com/api
Heads-up: Endpoints tagged with a yellow badge require that feature to be enabled in your subscription plan. Upgrade to Premium for full access.

Authentication

1. POST to /api/auth/login with email/password to receive a Bearer token.

2. Include the token in every subsequent request:

POST https://hrms.griomedglobal.com/api/auth/login
Content-Type: application/json

{
  "email": "admin@techcorp.in",
  "password": "Admin@2025"
}

→ Response:
{
  "token": "1|abc...xyz",
  "user": { ... }
}

# Subsequent requests:
GET https://hrms.griomedglobal.com/api/employees
Authorization: Bearer 1|abc...xyz
Accept: application/json

Announcements 3 endpoints

GET /api/announcements
POST /api/announcements
DELETE /api/announcements/{id}

Assets 5 endpoints

GET /api/assets asset_management
POST /api/assets asset_management
GET /api/assets/{id}
PUT /api/assets/{id}/assign asset_management
PUT /api/assets/{id}/return asset_management

Attendance 15 endpoints

GET /api/attendance
POST /api/attendance/checkin
POST /api/attendance/checkout
POST /api/attendance/import
GET /api/attendance/import-template
POST /api/attendance/manual
GET /api/attendance/qr-token
GET /api/attendance/regularization
POST /api/attendance/regularization
POST /api/attendance/regularization/{id}/approve
POST /api/attendance/regularization/{id}/reject
GET /api/attendance/report
GET /api/attendance/status
GET /api/attendance/today
POST /api/attendance/{id}/regularize

Audit Logs 3 endpoints

GET /api/audit-logs
GET /api/audit-logs/export
GET /api/audit-logs/stats

Auth 8 endpoints

PUT /api/auth/change-password
POST /api/auth/forgot-password
POST /api/auth/login
POST /api/auth/logout
POST /api/auth/logout-all
GET /api/auth/me
POST /api/auth/register
POST /api/auth/reset-password

Billing 7 endpoints

POST /api/billing/create-order
GET /api/billing/current
GET /api/billing/invoices
GET /api/billing/invoices/{id}/download
GET /api/billing/plans
POST /api/billing/verify-payment
POST /api/billing/webhook

Branch Transfers 5 endpoints

GET /api/branch-transfers
POST /api/branch-transfers
POST /api/branch-transfers/apply-due
POST /api/branch-transfers/{id}/approve
POST /api/branch-transfers/{id}/reject

Branches 3 endpoints

GET /api/branches
POST /api/branches
PUT /api/branches/{id}

Calendar 1 endpoints

GET /api/calendar

Compliance 6 endpoints

GET /api/compliance
POST /api/compliance
GET /api/compliance/dashboard
PATCH /api/compliance/{id}
DELETE /api/compliance/{id}
POST /api/compliance/{id}/complete

Crm 14 endpoints

GET /api/crm/assignable-users crm
GET /api/crm/leads crm
POST /api/crm/leads crm
GET /api/crm/leads/analytics crm
POST /api/crm/leads/bulk-assign crm
POST /api/crm/leads/bulk-import crm
GET /api/crm/leads/follow-ups crm
GET /api/crm/leads/staff-report crm
GET /api/crm/leads/{id} crm
PUT /api/crm/leads/{id} crm
DELETE /api/crm/leads/{id} crm
GET /api/crm/leads/{id}/activities crm
POST /api/crm/leads/{id}/activity crm
PUT /api/crm/leads/{id}/stage crm

Custom Roles 6 endpoints

GET /api/custom-roles
POST /api/custom-roles
GET /api/custom-roles/permissions-matrix
GET /api/custom-roles/{id}
PUT /api/custom-roles/{id}
DELETE /api/custom-roles/{id}

Departments 4 endpoints

GET /api/departments
POST /api/departments
PUT /api/departments/{id}
DELETE /api/departments/{id}

Designations 4 endpoints

GET /api/designations
POST /api/designations
PUT /api/designations/{id}
DELETE /api/designations/{id}

Documents 7 endpoints

GET /api/documents document_management
POST /api/documents document_management
DELETE /api/documents/{id} document_management
POST /api/documents/{id}/acknowledge document_management
GET /api/documents/{id}/acknowledgments document_management
GET /api/documents/{id}/preview document_management
POST /api/documents/{id}/version document_management

Employees 12 endpoints

GET /api/employees
POST /api/employees
POST /api/employees/bulk-import
GET /api/employees/import-template
GET /api/employees/my-team
POST /api/employees/sync-folders
GET /api/employees/{id}
PUT /api/employees/{id}
DELETE /api/employees/{id}
GET /api/employees/{id}/letter/{type}
PUT /api/employees/{id}/rehire
PUT /api/employees/{id}/terminate

Exit 6 endpoints

GET /api/exit
POST /api/exit
GET /api/exit/{id}
PUT /api/exit/{id}/checklist
POST /api/exit/{id}/generate-letter
PUT /api/exit/{id}/settlement

Expenses 6 endpoints

GET /api/expenses expense_management
POST /api/expenses expense_management
GET /api/expenses/{id}
DELETE /api/expenses/{id} expense_management
PUT /api/expenses/{id}/approve expense_management
PUT /api/expenses/{id}/reject expense_management

Folders 5 endpoints

GET /api/folders document_management
POST /api/folders document_management
PUT /api/folders/{id} document_management
DELETE /api/folders/{id} document_management
PUT /api/folders/{id}/permissions document_management

Grievances 7 endpoints

GET /api/grievances grievance
POST /api/grievances grievance
GET /api/grievances/stats grievance
GET /api/grievances/{id} grievance
PUT /api/grievances/{id}/assign grievance
PUT /api/grievances/{id}/close grievance
PUT /api/grievances/{id}/resolve grievance

Holidays 4 endpoints

GET /api/holidays
POST /api/holidays
POST /api/holidays/bulk
DELETE /api/holidays/{id}

It Declaration 7 endpoints

GET /api/it-declaration/current
GET /api/it-declaration/my
GET /api/it-declaration/pending
POST /api/it-declaration/proofs
GET /api/it-declaration/proofs
PUT /api/it-declaration/{id}
POST /api/it-declaration/{id}/verify

Kpi 13 endpoints

GET /api/kpi/cycles kpi
POST /api/kpi/cycles kpi
PUT|POST /api/kpi/cycles/{id}/close kpi
GET /api/kpi/definitions kpi
POST /api/kpi/definitions kpi
PUT /api/kpi/definitions/{id} kpi
DELETE /api/kpi/definitions/{id} kpi
GET /api/kpi/entries kpi
POST /api/kpi/entries kpi
POST /api/kpi/entries/peer-review kpi
PUT /api/kpi/entries/{id}/manager-rating kpi
GET /api/kpi/report kpi
GET /api/kpi/team-report kpi

Leaves 14 endpoints

GET /api/leaves
POST /api/leaves
GET /api/leaves/balance
GET /api/leaves/balances
GET /api/leaves/balances/export
POST /api/leaves/credit-annual
GET /api/leaves/types
POST /api/leaves/types
PUT /api/leaves/types/{id}
DELETE /api/leaves/types/{id}
GET /api/leaves/{id}
PUT /api/leaves/{id}/approve
PUT /api/leaves/{id}/cancel
PUT /api/leaves/{id}/reject

Loans 13 endpoints

GET /api/loans loan_management
POST /api/loans loan_management
POST /api/loans/accounts/{id}/foreclosure loan_management
GET /api/loans/accounts/{id}/schedule loan_management
POST /api/loans/calculate loan_management
GET /api/loans/types loan_management
POST /api/loans/types loan_management
PUT /api/loans/types/{id} loan_management
DELETE /api/loans/types/{id} loan_management
GET /api/loans/{id} loan_management
PUT /api/loans/{id}/approve loan_management
POST /api/loans/{id}/disburse loan_management
PUT /api/loans/{id}/reject loan_management

Notifications 6 endpoints

GET /api/notifications
POST /api/notifications/fcm-token
PUT /api/notifications/read-all
POST /api/notifications/send-push
DELETE /api/notifications/{id}
PUT /api/notifications/{id}/read

Offer Letters 4 endpoints

GET /api/offer-letters
POST /api/offer-letters
POST /api/offer-letters/{id}/resend
POST /api/offer-letters/{id}/revoke

Onboarding 8 endpoints

GET /api/onboarding
POST /api/onboarding
GET /api/onboarding/my-tasks
POST /api/onboarding/tasks
PUT|PATCH /api/onboarding/tasks/{id}
DELETE /api/onboarding/tasks/{id}
POST /api/onboarding/tasks/{id}/complete
POST /api/onboarding/{employeeId}/remind

Payroll 11 endpoints

GET /api/payroll payroll
GET /api/payroll/payslips payroll
GET /api/payroll/payslips/{id}/download payroll
GET /api/payroll/report/pf payroll
POST /api/payroll/run payroll
POST /api/payroll/salary payroll
GET /api/payroll/setup payroll
PUT /api/payroll/setup payroll
GET /api/payroll/{id} payroll
PUT /api/payroll/{id}/approve payroll
POST /api/payroll/{runId}/email payroll

Recruitment 20 endpoints

GET /api/recruitment/applications recruitment
PUT /api/recruitment/applications/{id}/stage recruitment
GET /api/recruitment/candidates recruitment
POST /api/recruitment/candidates recruitment
POST /api/recruitment/candidates/bulk-import recruitment
GET /api/recruitment/candidates/{id} recruitment
PUT|PATCH /api/recruitment/candidates/{id} recruitment
POST /api/recruitment/candidates/{id}/status recruitment
GET /api/recruitment/interviews recruitment
POST /api/recruitment/interviews recruitment
POST /api/recruitment/interviews/{id}/feedback recruitment
GET /api/recruitment/jobs recruitment
POST /api/recruitment/jobs recruitment
GET /api/recruitment/jobs/{id} recruitment
PUT /api/recruitment/jobs/{id} recruitment
POST /api/recruitment/offers recruitment
PUT /api/recruitment/offers/{id}/accept recruitment
PUT /api/recruitment/offers/{id}/reject recruitment
PUT /api/recruitment/offers/{id}/send recruitment
POST /api/recruitment/refer recruitment

Referrals 2 endpoints

GET /api/referrals
POST /api/referrals/{id}/pay-bonus

Rent Receipts 2 endpoints

POST /api/rent-receipts
GET /api/rent-receipts

Reports 10 endpoints

GET /api/reports/attendance
GET /api/reports/expenses
GET /api/reports/headcount
GET /api/reports/hr-dashboard
GET /api/reports/leave-analysis
GET /api/reports/loans
GET /api/reports/recruitment
GET /api/reports/salary
GET /api/reports/tasks
GET /api/reports/{type}/export

Roster 4 endpoints

GET /api/roster
POST /api/roster
POST /api/roster/swap-request
PUT /api/roster/swap-request/{id}/approve

Salary Components 4 endpoints

GET /api/salary-components
POST /api/salary-components
PUT /api/salary-components/{id}
DELETE /api/salary-components/{id}

Settings 25 endpoints

GET /api/settings/attendance
PUT /api/settings/attendance
GET /api/settings/company
PUT /api/settings/company
POST /api/settings/company/logo
GET /api/settings/geo-fence
PUT /api/settings/geo-fence
GET /api/settings/integrations
PUT /api/settings/integrations
GET /api/settings/master-data
GET /api/settings/notifications
PUT /api/settings/notifications
GET /api/settings/payroll
PUT /api/settings/payroll
GET /api/settings/shifts
POST /api/settings/shifts
PUT /api/settings/shifts/{id}
DELETE /api/settings/shifts/{id}
GET /api/settings/signatories
POST /api/settings/signatories
POST /api/settings/signatories/upload
PUT /api/settings/signatories/{id}
DELETE /api/settings/signatories/{id}
GET /api/settings/working-hours
PUT /api/settings/working-hours

Tasks 14 endpoints

GET /api/tasks task_assignment
POST /api/tasks task_assignment
GET /api/tasks/analytics task_assignment
PUT /api/tasks/checklist/{itemId}/toggle task_assignment
POST /api/tasks/dwr task_assignment
GET /api/tasks/dwr/list task_assignment
PUT /api/tasks/dwr/{id}/feedback task_assignment
GET /api/tasks/{id} task_assignment
PUT /api/tasks/{id} task_assignment
DELETE /api/tasks/{id} task_assignment
POST /api/tasks/{id}/checklist task_assignment
POST /api/tasks/{id}/comments task_assignment
PUT /api/tasks/{id}/status task_assignment
POST /api/tasks/{id}/time-log task_assignment

Telecaller 2 endpoints

GET /api/telecaller/leads
GET /api/telecaller/stats

Tickets 10 endpoints

GET /api/tickets helpdesk
POST /api/tickets helpdesk
GET /api/tickets/dashboard helpdesk
GET /api/tickets/{id} helpdesk
PUT /api/tickets/{id}/assign helpdesk
PUT /api/tickets/{id}/close helpdesk
GET /api/tickets/{id}/comments helpdesk
POST /api/tickets/{id}/comments helpdesk
POST /api/tickets/{id}/rating helpdesk
PUT /api/tickets/{id}/resolve helpdesk

Training 10 endpoints

GET /api/training training
POST /api/training training
GET /api/training/analytics training
PUT /api/training/enrollment/{id}/complete training
GET /api/training/my training
POST /api/training/self-enroll/{id} training
GET /api/training/{id} training
PUT /api/training/{id} training
DELETE /api/training/{id} training
POST /api/training/{id}/enroll training

Found 310 API endpoints across 40 groups.