---
updatedAt: 2025-10-16T12:46:43.000Z
agentTools:
  projectIndex: https://clayhr.readme.io/llms.txt
---

# Retrieve skills assigned to a user

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Skills",
    "version": "1.0",
    "contact": {}
  },
  "servers": [
    {
      "url": "https://acmecompany.clayhr.com/rm"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/api/v3/userSkill": {
      "get": {
        "tags": [
          "Skills"
        ],
        "summary": "Retrieve skills assigned to a user",
        "description": "",
        "operationId": "get-skills-assigned-to-a-user",
        "parameters": [
          {
            "name": "assignedUserID",
            "in": "query",
            "description": "The ID of the user whose skills should be retrieved.",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "userid",
            "in": "header",
            "description": "The ID of the user to authenticate.",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "x-api-key",
            "in": "header",
            "description": "The API key of the user to authenticate.",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"data\": [                       \n        {\n            \"skillUserId\": \"int\",\n            \"skillId\": \"int\",\n            \"userId\": \"int\",\n            \"level\": \"int\",\n            \"description\": \"string\",\n            \"cid\": \"int\",\n            \"lastUpdateUserModel\": \"int\",\n            \"createUserId\": \"int\",\n            \"status\": \"string\",\n            \"createts\": \"int\",\n            \"performancelevel\": \"int\",\n            \"candidateid\": \"int\",\n            \"weightage\": \"int\",\n            \"targetLevel\": \"int\",\n            \"targetLevelCreatets\": \"int\",\n            \"targetLevelCreateUserId\": \"int\",\n            \"skillCounsellor\": \"string\",\n            \"yearsOfExperience\": \"int\",\n            \"dateOfLastUse\": \"int\",\n            \"skillAcquireDate\": \"int\",\n            \"skillModel\": {\n                \"skillId\": \"int\",\n                \"skillCode\": \"string\",\n                \"description\": \"string\",\n                \"cid\": \"int\",\n                \"skillTypeModel\": \"string\",\n                \"assessmentModel\": {\n                    \"scoretemplateid\": \"int\",\n                    \"cid\": \"int\",\n                    \"scoreMin\": \"int\",\n                    \"scoreMax\": \"int\",\n                    \"scoreMaxValidation\": \"int\",\n                    \"scoringInstructions\": \"string\",\n                    \"scoreName\": \"string\",\n                    \"allowFractional\":\"int\",\n                    \"rangeModelList\": [\n                        {\n                            \"strangeid\": \"int\",\n                            \"scoreTempId\": \"int\",\n                            \"rangeMin\": \"int\",\n                            \"rangeMax\": \"int\",\n                            \"interpretation\": \"string\",\n                            \"colorCode\": \"string\",\n                            \"cid\": \"int\",\n                            \"description\": \"string\"\n                        },\n                        {\n                            \"strangeid\": \"int\",\n                            \"scoreTempId\": \"int\",\n                            \"rangeMin\": \"int\",\n                            \"rangeMax\": \"int\",\n                            \"interpretation\": \"string\",\n                            \"colorCode\": \"string\",\n                            \"cid\": \"int\",\n                            \"description\": \"string\"\n                        }\n                    ],\n                    \"visualizationType\": \"string\",\n                    \"status\": \"string\"\n                },\n                \"sequence\": \"int\",\n                \"skillTypeName\": \"string\",\n                \"userSkillLevel\": \"int\",\n                \"status\": \"string\",\n                \"createUserId\": \"int\",\n                \"createts\": \"int\"\n            }\n        }\n    ],\n    \"message\": \"List of skills fetched successfully.\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "skillUserId": {
                            "type": "string",
                            "example": "int"
                          },
                          "skillId": {
                            "type": "string",
                            "example": "int"
                          },
                          "userId": {
                            "type": "string",
                            "example": "int"
                          },
                          "level": {
                            "type": "string",
                            "example": "int"
                          },
                          "description": {
                            "type": "string",
                            "example": "string"
                          },
                          "cid": {
                            "type": "string",
                            "example": "int"
                          },
                          "lastUpdateUserModel": {
                            "type": "string",
                            "example": "int"
                          },
                          "createUserId": {
                            "type": "string",
                            "example": "int"
                          },
                          "status": {
                            "type": "string",
                            "example": "string"
                          },
                          "createts": {
                            "type": "string",
                            "example": "int"
                          },
                          "performancelevel": {
                            "type": "string",
                            "example": "int"
                          },
                          "candidateid": {
                            "type": "string",
                            "example": "int"
                          },
                          "weightage": {
                            "type": "string",
                            "example": "int"
                          },
                          "targetLevel": {
                            "type": "string",
                            "example": "int"
                          },
                          "targetLevelCreatets": {
                            "type": "string",
                            "example": "int"
                          },
                          "targetLevelCreateUserId": {
                            "type": "string",
                            "example": "int"
                          },
                          "skillCounsellor": {
                            "type": "string",
                            "example": "string"
                          },
                          "yearsOfExperience": {
                            "type": "string",
                            "example": "int"
                          },
                          "dateOfLastUse": {
                            "type": "string",
                            "example": "int"
                          },
                          "skillAcquireDate": {
                            "type": "string",
                            "example": "int"
                          },
                          "skillModel": {
                            "type": "object",
                            "properties": {
                              "skillId": {
                                "type": "string",
                                "example": "int"
                              },
                              "skillCode": {
                                "type": "string",
                                "example": "string"
                              },
                              "description": {
                                "type": "string",
                                "example": "string"
                              },
                              "cid": {
                                "type": "string",
                                "example": "int"
                              },
                              "skillTypeModel": {
                                "type": "string",
                                "example": "string"
                              },
                              "assessmentModel": {
                                "type": "object",
                                "properties": {
                                  "scoretemplateid": {
                                    "type": "string",
                                    "example": "int"
                                  },
                                  "cid": {
                                    "type": "string",
                                    "example": "int"
                                  },
                                  "scoreMin": {
                                    "type": "string",
                                    "example": "int"
                                  },
                                  "scoreMax": {
                                    "type": "string",
                                    "example": "int"
                                  },
                                  "scoreMaxValidation": {
                                    "type": "string",
                                    "example": "int"
                                  },
                                  "scoringInstructions": {
                                    "type": "string",
                                    "example": "string"
                                  },
                                  "scoreName": {
                                    "type": "string",
                                    "example": "string"
                                  },
                                  "allowFractional": {
                                    "type": "string",
                                    "example": "int"
                                  },
                                  "rangeModelList": {
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "strangeid": {
                                          "type": "string",
                                          "example": "int"
                                        },
                                        "scoreTempId": {
                                          "type": "string",
                                          "example": "int"
                                        },
                                        "rangeMin": {
                                          "type": "string",
                                          "example": "int"
                                        },
                                        "rangeMax": {
                                          "type": "string",
                                          "example": "int"
                                        },
                                        "interpretation": {
                                          "type": "string",
                                          "example": "string"
                                        },
                                        "colorCode": {
                                          "type": "string",
                                          "example": "string"
                                        },
                                        "cid": {
                                          "type": "string",
                                          "example": "int"
                                        },
                                        "description": {
                                          "type": "string",
                                          "example": "string"
                                        }
                                      }
                                    }
                                  },
                                  "visualizationType": {
                                    "type": "string",
                                    "example": "string"
                                  },
                                  "status": {
                                    "type": "string",
                                    "example": "string"
                                  }
                                }
                              },
                              "sequence": {
                                "type": "string",
                                "example": "int"
                              },
                              "skillTypeName": {
                                "type": "string",
                                "example": "string"
                              },
                              "userSkillLevel": {
                                "type": "string",
                                "example": "int"
                              },
                              "status": {
                                "type": "string",
                                "example": "string"
                              },
                              "createUserId": {
                                "type": "string",
                                "example": "int"
                              },
                              "createts": {
                                "type": "string",
                                "example": "int"
                              }
                            }
                          }
                        }
                      }
                    },
                    "message": {
                      "type": "string",
                      "example": "List of skills fetched successfully."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "401",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"message\": \"Access denied! Either Authorization or x-api-key & userid parameters are not present/valid.\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "example": "Access denied! Either Authorization or x-api-key & userid parameters are not present/valid."
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "409",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"message\": \"Error while getting skills assigned to a user from API.\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "example": "Error while getting skills assigned to a user from API."
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true,
    "samples-enabled": true
  },
  "x-readme-fauxas": true
}
```