About iMochaHelpBook a demo
About iMochaHelpBook a demo
  1. Employee
  • Introduction
  • Skills Assessment API
    • API Reference
      • Getting started
      • API Environment
      • Authentication Mechanism
      • Error Code
      • List timezones
    • Test
      • List all tests
      • Retrieve a test
      • Retrieve test settings
      • Update Test Settings
    • Test Invitations
      • Callback notification
      • Invite candidate
      • Invite candidate by test link
      • Reattempt Test
      • Cancel Invitation
    • Test Link
      • List all test links
    • Report
      • Retrieve candidate test report
      • Retrieve candidate test report in PDF
    • Callback API
      • Process Callbacks
      • Retrieve Invites
    • GDPR
      • GDPR Data Masking Service
    • Users
      • Get all business units
      • Create New User
      • Update User
      • Active/ Inactive User
  • Skills Intelligence API
    • Introduction
    • Authentication
    • Employee
      • List employees
        GET
      • Get Employee Skills by employeeId
        GET
      • Employee Enrollment
        POST
      • Update Employee Status
        PATCH
    • JobProfiles
      • Get All JobProfiles
      • Get JobProfile with Skills By JobProfileId
      • Create JobCode
    • Taxonomy
      • Get all Taxonomy Skills
    • CareerPath
      • Get Employee Career Path by employeeId
    • Account
      • Get Multichannel Validation Weightages
  1. Employee

List employees

GET
/employees
Retrieves a paginated list of employees along with key profile details, organizational attributes, and job profile information.

Request

Query Params

Header Params

Responses

🟢200OK
text/plain
OK
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.skillsintelligence.imocha.io/employees' \
--header 'x-api-key;'
Response Response Example
{
    "items": [
        {
            "employeeId": 0,
            "externalEmployeeId": "string",
            "email": "string",
            "fullName": "string",
            "status": "string",
            "enrolledOn": "2019-08-24T14:15:22Z",
            "lastLogin": "2019-08-24T14:15:22Z",
            "department": "string",
            "location": "string",
            "managerEmail": "string",
            "employmentType": "string",
            "grade": "string",
            "band": "string",
            "experience": 0,
            "dateOfJoining": "2019-08-24T14:15:22Z",
            "dateOfExit": "2019-08-24T14:15:22Z",
            "jobProfile": {
                "jobProfileId": 0,
                "jobProfileName": "string"
            }
        }
    ],
    "pageNumber": 0,
    "totalPages": 0,
    "totalCount": 0,
    "hasPreviousPage": true,
    "hasNextPage": true
}
Modified at 2025-07-08 07:13:39
Previous
Employee
Next
Get Employee Skills by employeeId
Built with