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
      • Bulk Invite
      • Reattempt Test
      • Cancel Invitation
    • Test Link
      • List all test links
      • Create Test Link
      • Update Test Link
    • Report
      • Retrieve candidate test report
      • Retrieve candidate test report in PDF
      • Get Reports By TestId
      • Get All Reports
    • Callback API
      • Process Callbacks
      • Retrieve Invites
    • GDPR
      • GDPR Data Masking Service
    • Users
      • Get all business units
      • Create New User
      • Update User
      • Active/ Inactive User
    • Tara Interview API
      • Introduction
      • Get All Interviews
      • Schedule Interview
      • Get Detailed Report
      • Get All Reports
  • Skills Intelligence API
    • Introduction
    • Authentication
    • Employee
      • List employees
        GET
      • Get Employee Skills by employeeId
        GET
      • Employee Enrollment
        POST
      • Get Employee Certificates
        GET
      • Update Employee Status
        PATCH
      • Get Employee Assessment Report
        GET
      • Upload Certificate for Employee
        POST
      • Upload Resume for Employee
        POST
      • List Employees with Skills Profile
        GET
      • Assign Learning to Employee
        POST
      • Get Employee Skill Gap
        GET
    • 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 Rubric Levels
      • Get Multichannel Validation Weightages
    • Learning
      • Create Learning Resources
      • Get all Learning Resources
    • Certificates
      • Create certificate with skills
      • Get all Certificates
  1. Employee

List Employees with Skills Profile

GET
/employees/skills-profile
Retrieves a paginated list of employees along with their associated skill profiles. Each employee record includes basic details (such as employee ID, external ID, email, and full name) and a list of skills with proficiency, validation scores, AI-inferred ratings, and classification metadata.
The response supports optional filtering based on the skill modifiedOn timestamp, allowing clients to fetch only employees whose skill data has been updated after a specified date.
Each skill object contains detailed attributes including:
Skill identifiers and taxonomy mapping
Skill classification details
Various validation scores (self, manager, AI inference, etc.)
Weighted proficiency and AI inference scores
Skill gap and required proficiency metrics
AI-inferred ratings with explanations (if available)
The API returns paginated results with metadata such as current page number, total pages, total record count, and navigation flags (hasNextPage, hasPreviousPage).
Default page size is 50, with a maximum limit of 100.

Request

Query Params

Header Params

Responses

🟢200Success
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.skillsintelligence.imocha.io/employees/skills-profile?pageNumber=1&pageSize=50&SkillProfileModifiedSince=2026-04-23T01%3A45%3A53Z&searchText=ananya.shah89%40yopmail.com&includeProficiencyAudit=false' \
--header 'x-api-key;'
Response Response Example
{
    "items": [
        {
            "employeeId": 97169,
            "externalEmployeeId": "Testexid",
            "email": "[email protected]",
            "fullName": "test",
            "skills": [
                {
                    "skill": {
                        "skillId": 7378,
                        "skillName": "A/B Testing",
                        "taxonomySkillExternalId": "25xx",
                        "modifiedOn": "2026-04-22T08:59:22.933",
                        "skillClassification": {
                            "classificationId": 10318,
                            "classificationName": "Skill_3"
                        }
                    },
                    "selfValidationScore": null,
                    "iMochaValidationScore": null,
                    "managerValidationScore": null,
                    "weightedProficiencyScore": 6.00,
                    "multiRaterValidationScore": null,
                    "weightedAIInferenceScore": 6,
                    "experienceInMonths": null,
                    "aiInferredRatings": [
                        {
                            "inferenceType": 1,
                            "rating": 6,
                            "talentAlteredRating": null,
                            "explanation": "Used in E-Commerce Order Processing System and professional experience at XYZ Innovations."
                        }
                    ],
                    "isJobProfileSkill": false,
                    "skillPriorirty": null,
                    "skillRequiredProficiency": 10,
                    "skillGapInPercentage": 40
                },
                {
                    "skill": {
                        "skillId": 19442,
                        "skillName": "Python Developer",
                        "taxonomySkillExternalId": "2335",
                        "modifiedOn": "2026-04-22T08:59:22.933",
                        "skillClassification": {
                            "classificationId": 11520,
                            "classificationName": "dot net developer"
                        }
                    },
                    "selfValidationScore": null,
                    "iMochaValidationScore": null,
                    "managerValidationScore": null,
                    "weightedProficiencyScore": 8.00,
                    "multiRaterValidationScore": null,
                    "weightedAIInferenceScore": 8,
                    "experienceInMonths": null,
                    "aiInferredRatings": [
                        {
                            "inferenceType": 1,
                            "rating": 8,
                            "talentAlteredRating": null,
                            "explanation": "Used in AI Resume Screening Platform, Automated Testing & QA Framework, Data Analytics Dashboard, and professional experience at ABC Tech Solutions."
                        }
                    ],
                    "isJobProfileSkill": false,
                    "skillPriorirty": null,
                    "skillRequiredProficiency": 10,
                    "skillGapInPercentage": 20
                }
            ]
        }
    ],
    "pageNumber": 1,
    "totalPages": 25,
    "totalCount": 1226,
    "hasPreviousPage": false,
    "hasNextPage": true
}
Modified at 2026-08-24 05:22:02
Previous
Upload Resume for Employee
Next
Assign Learning to Employee
Built with