Get Data Definition
GET /ws/rest/service/v1/ds/data-def
Version: 20.11
Purpose
Gets a list of data definitions.
Request Format
All parameters should be URL encoded.
Sample Filter Query Parameter
type = Basic / Cost Codes / Data Picker
filter =
{
"name": "Sample DD Name",
"data_source": ""
}
Notes:
- All field values in the filter object are case insensitive type is case insensitive.
- If filter object is not provided in the request, all data definitions list will be returned
- Condition type contains will be used to fetch the data definitions
- Filter condition will be applied only if the provided filter values are not-null/non-empty.
- type: possible values will be Basic, Cost Codes, Data Picker
- name: Name of the Data definition
- data_source: Data source of the data picker. Only applicable for data picker type.
Response Format
A JSON object is returned in the following format:
{
"data": [],
"message": [],
"status": <REST status code value>
}
A successful response displays a status code 200.
A failed response displays a message with a status code.
Sample Success Response
This is an example of a response with a status code 200.
{
"data": [
{
"data_size": 0,
"name": "Account Code Picker",
"data_type": "Integer",
"input_type": "Picker",
"used": "Yes",
"category": "System"
},
{
"data_size": 128,
"name": "Account Type PD",
"data_type": "String",
"input_type": "Pull-down Menu",
"data_set": [],
"used": "Yes",
"category": "Company"
},
{
"data_size": 128,
"name": "Action Required PD",
"data_type": "String",
"input_type": "Pull-down Menu",
"dataset_non_modifiable": "No",
"data_set": [
{
"status": "Active",
"value": "No",
"label": "No",
"row_num": 1,
"is_default": "No"
},
{
"status": "Active",
"value": "Yes",
"label": "Yes",
"row_num": 2,
"is_default": "No"
}
],
"used": "Yes",
"category": "^Company"
}
],
"message": ["success"],
"status": 200
}
Sample Response to Get Data Definition of Cost Code Type
This is an example of a successful response for getting data definitions of cost code type.
{
"data": [{
"data_size": 32,
"name": "Segment 1",
"data_type": "String",
"input_type": "Text Box",
"used": "Yes",
"label": "Segment 1",
"category": "CBS Code"
},
{
"data_size": 32,
"name": "segment 2",
"data_type": "String",
"input_type": "Pull-down Menu",
"label": "Segment 2",
"dataset_non_modifiable": "Yes",
"data_set": [
{
"status": "Active",
"value": "Yes",
"label": "Yes",
"row_num": 1,
"is_default": "No"
},
{
"status": "Active",
"value": "No",
"label": "No",
"row_num": 2,
"is_default": "No"
}
],
"used": null,
"category": "CBS Code"
}
],
"message": ["success"],
"status": 200
}
Sample Response to Get Data Definition of Data Pickers Type
This is an example of a successful response for getting data definitions of data pickers type.
{
"data": [
{
"data_element": "uuu_user_name",
"display_element": "Name",
"name": "Action Item Approver DP",
"used": "Yes",
"category": "User Attributes",
"data_source": "User Attributes"
},
{
"data_element": "space_sp_space_name",
"display_element": "Space Name",
"name": "Usable Space DP",
"used": "Yes",
"category": "Space Manager",
"data_source": "Usable Space"
},
{
"data_element": "ugenPropertyName",
"display_element": "Property Name",
"name": "Property DP",
"used": "Yes",
"category": "Business Process",
"data_source": "Prospective Properties"
},
{
"data_element": "uveVendorNameTB50",
"display_element": "Vendor Name",
"name": "Vendors PK",
"used": "Yes",
"category": "Business Process",
"data_source": "Vendors"
}
],
"message": ["success"],
"status": 200
}
Related Topics
Last Published Tuesday, July 1, 2025