URL

GET https://{api-url}/api/v2/tenants/{tenantId}/customFields/{classCode}

Sample URLs

https://{api-url}/api/v2/tenants/client_7/customFields/CHANGE

Use the supported entities along with their class code:

EntityClass Code
Service requestSERVICEREQUEST
Time-bound requestACSTICKET
TaskTASK
IncidentINCIDENT
ProblemPROBLEM
Change requestCHANGE
Scheduled tasksSCHEDULEDTASK
UserUSER
Knowledge base articleKBARTICLE

Create custom fields for the entity and then use this endpoint to retrieve the list of configured custom fields.

To create an ITSM entity, both Subject and Description are mandatory fields. Requested By, Assignee Group, and the other fields are optional. To include additional information, create custom fields for the respective entity from the following types of custom fields:

  • Drop-down
  • Text
  • Multi-line text
  • Numeric
  • Checkbox
  • Date
  • Date-time

Status code

200 OK

Sample response

[{
		"id": "UDF0000003790",
		"classCode": "CHANGE",
		"displayLabel": "Status",
		"name": "drop_down_api_lab_3790",
		"fieldType": "TYPE_DROPDOWN",
		"mandatory": false,
		"editable": true,
		"description": "Status of incident ",
		"defaultValue": "2",
		"options": [{
				"label": "Open",
				"value": "1"
			},
			{
				"label": "In Progress",
				"value": "2"
			}
		]
	},
	{
		"id": "UDF0000003791",
		"classCode": "CHANGE",
		"displayLabel": "Component",
		"name": "text_api_lab_3791",
		"fieldType": "TYPE_TEXT",
		"mandatory": false,
		"editable": true,
		"defaultValue": "sample text",
		"description": "Test case for text field"
	},
	{
		"id": "UDF0000003792",
		"classCode": "CHANGE",
		"displayLabel": "Summary",
		"name": "multi_line_text_api_lab_3792",
		"fieldType": "TYPE_TEXTAREA",
		"mandatory": false,
		"editable": true,
		"defaultValue": "sample text",
		"description": "Test case for multi line text"
	},
	{
		"id": "UDF0000003793",
		"classCode": "CHANGE",
		"displayLabel": "Version",
		"name": "numeric_api_lab_3793",
		"fieldType": "TYPE_NUMBER",
		"mandatory": false,
		"editable": true,
		"defaultValue": "5",
		"description": "Numeric test case"
	},
	{
		"id": "UDF0000003794",
		"classCode": "CHANGE",
		"displayLabel": "Active",
		"name": "checkbox_api_lab_3794",
		"fieldType": "TYPE_CHECKBOX",
		"mandatory": false,
		"editable": true,
		"description": "Test case for check box",
		"options": [{
			"label": "yes",
			"value": "1"
		}]
	},
	{
		"id": "UDF0000003795",
		"classCode": "CHANGE",
		"displayLabel": "Reported on",
		"name": "date_ap_lab_3795",
		"fieldType": "TYPE_DATE",
		"mandatory": false,
		"editable": true,
		"description": "Test case for date field"
	},
	{
		"id": "UDF0000003796",
		"classCode": "CHANGE",
		"displayLabel": "Reported time",
		"name": "datetime_api_lab_3796",
		"fieldType": "TYPE_DATETIME",
		"mandatory": false,
		"editable": true,
		"defaultValue": "2016-04-24 10:19",
		"description": "Test case for Date and time"
	}
]