API: Case Fields

Use the following API methods to request details about custom fields for test cases.


Returns a list of available test case custom fields.

GET index.php?/api/v2/get_case_fields

Response content

The response includes an array of custom field definitions. Please see below for a typical response:

		"configs": [
			"context": {
				"is_global": true,
				"project_ids": null
			"id": "..",
			"options": {
				"default_value": "",
				"format": "markdown",
				"is_required": false,
				"rows": "5"
		"description": "The preconditions of this test case. ..",
		"display_order": 1,
		"id": 1,
		"label": "Preconditions",
		"name": "preconds",
		"system_name": "custom_preconds",
		"type_id": 3

A custom field can have different configurations and options per project which is indicated by the configs field. To check if a custom field is applicable to a specific project (and to find out the field options for this project), the context of the field configuration must either be global (is_global) or include the ID of the project in project_ids.

Also, the following list shows the available custom field types (type_id field):

Type ID Name
1 String
2 Integer
3 Text
5 Checkbox
6 Dropdown
7 User
8 Date
9 Milestone
10 Steps
12 Multi-select

Response codes

200 Success, the available custom fields are returned as part of the response