GET/directory/employment-types

Gets a list of employment types.

Note

  • The useEmploymentType parameter for the domain must be set to "true" to use this API operation.

Caution
Support for this API operation is scheduled to end. Please use Get user types .

Authorization

oauth2

OAuth 2.0 authentication.
For more information, see Authentication and Authorization.

Scope

directory
directory.read

HTTP Request

GEThttps://www.worksapis.com/v1.0/directory/employment-types

Query Parameters

ParameterTypeDescription
domainId integer 

Domain ID


example : 10000001
format : int32 
count integer 

Number of items to get


default : 100
minimum : 1
maximum : 100
example : 100
format : int32 
cursor string 

Cursor


example : JlIBsfJogXpzDGY8OscZziqZpYqCAu3RbZbaFzBb1od6lWQtSdPUd2FIdCuaGgu8DA== 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Response

HTTP 200

OK

PropertyTypeDescription
employmentTypes array (EmploymentType) 

Employment type information

 
responseMetaData object (responseMetaData) 

Response metadata

 

EmploymentType

PropertyTypeDescription
domainId integer 

Domain ID of the employment type


required
format : int32 
employmentTypeId string 

It is automatically assigned.


readOnly : true 
displayOrder integer 

Sort order. A negative or duplicate number is allowed. Based on this value, items are sorted in ascending order.


required
format : int32 
employmentTypeName string 

Employment type name. It must be unique within the domain. The allowed special characters are ! @ & ( ) - _ + [ ] { } , . /.


required
maxLength : 100 
employmentTypeExternalKey string 

Employment type external key. It must be unique within a tenant.
Some special characters, \ % # / ? are not allowed.


maxLength : 100
nullable : true 
i18nNames array (i18nName) 

Multi-language information.
It shows only the languages specified under Settings > Company Information > Set Multi-language in the LINE WORKS Admin.

 
userTypeCode string 

User type code. It can include any combination of alphabetic characters (A-Z, a-z), numbers (0-9), or underline symbols (_) and can be up to 50 characters long. It must start with an English letter.


maxLength : 50
nullable : true 

i18nName

PropertyTypeDescription
name string 

Multilingual name


required
minLength : 1
maxLength : 100 
language string 

Language code


required
Allowed values : ko_KR, en_US, ja_JP, zh_CN, zh_TW 

responseMetaData

PropertyTypeDescription
nextCursor string 

Cursor value for pagination

 

Response Example

example

1{2  "employmentTypes": [3    {4      "domainId": 10000001,5      "employmentTypeId": "employ2c-f321-47a6-ac11-e81fcc23a8c3",6      "displayOrder": 1,7      "employmentTypeName": "EmploymentType Name1",8      "employmentTypeExternalKey": "EMPLOYMENTTYPE_EXT_01",9      "i18nNames": [10        {11          "name": "English Name",12          "language": "en_US"13        }14      ],15      "userTypeCode": "code"16    },17    {18      "domainId": 10000001,19      "employmentTypeId": "employ0f-997b-4f47-9267-463f15e908a3",20      "displayOrder": 1,21      "employmentTypeName": "EmploymentType Name2",22      "employmentTypeExternalKey": "EMPLOYMENTTYPE_EXT_02",23      "i18nNames": [24        {25          "name": "English Name",26          "language": "en_US"27        }28      ],29      "userTypeCode": "code"30    }31  ],32  "responseMetaData": {33    "nextCursor": "JlIBsfJogXpzDGY8OscZziqZpYqCAu3RbZbaFzBb1od6lWQtSdPUd2FIdCuaGgu8DA=="34  }35}

HTTP 403

Forbidden