About iMochaHelpBook a demo
About iMochaHelpBook a demo
  1. JobProfiles
  • 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 Employee Skills by employeeId
      • Employee Enrollment
      • Update Employee Status
    • JobProfiles
      • Get All JobProfiles
        GET
      • Get JobProfile with Skills By JobProfileId
        GET
      • Create JobCode
        POST
    • Taxonomy
      • Get all Taxonomy Skills
    • CareerPath
      • Get Employee Career Path by employeeId
    • Account
      • Get Multichannel Validation Weightages
  1. JobProfiles

Get JobProfile with Skills By JobProfileId

GET
/job-profiles/{jobProfileId}
Retrieves detailed information about a specific job profile identified by jobProfileId. This includes metadata such as the job role, department, location, experience requirements, associated taxonomy skills, and organizational context (e.g., job family, sector). The endpoint is primarily used for job profile management, skill alignment, employee-role matching, and organizational design.

Request

Path Params

Header Params

Responses

🟢200OK
text/plain
OK
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://api.skillsintelligence.imocha.io/job-profiles/{jobprofileid}' \
--header 'x-api-key;'
Response Response Example
{
  "jobProfileId": 0,
  "jobProfileName": "string",
  "jobCode": {
    "id": 0,
    "name": "string"
  },
  "jobRole": {
    "id": 0,
    "name": "string",
    "skillFramework": 1,
    "jobFamily": {
      "id": 0,
      "name": "string"
    },
    "sector": {
      "id": 0,
      "name": "string"
    }
  },
  "location": {
    "id": 0,
    "name": "string"
  },
  "status": 1,
  "jobDescription": {
    "description": "string",
    "explanation": "string"
  },
  "grade": {
    "id": 0,
    "name": "string"
  },
  "department": {
    "id": 0,
    "name": "string"
  },
  "publishedOn": "2025-09-04T06:53:06.380Z",
  "isAssigned": true,
  "yearOfExperience": {
    "from": 0,
    "to": 0
  },
  "jobProfileTaxonomySkills": [
    {
      "jobProfileSkillId": 0,
      "taxonomySkillId": 0,
      "taxonomySkillExternalId": "string",
      "skillId": 0,
      "skillName": "string",
      "description": "string",
      "explanation": "string",
      "jobProfileSkillSource": 1,
      "skillClassification": {
        "classificationId": 0,
        "classificationName": "string"
      },
      "priority": 0,
      "proficiency": 0,
      "action": 0
    }
  ]
}
Modified at 2025-08-19 13:29:01
Previous
Get All JobProfiles
Next
Create JobCode
Built with