GET /v2/user-extension/
Overview
Queries rows from a User Extension (UE) table. Supports optional column filters and audit date filtering. Filters may be supplied as raw frontend field names or as generic objectKey placeholders — the endpoint resolves either form to the correct columns at runtime. Call GET /v2/user-extension/definition/{tableCode} first if you need to know what objectKey1, objectKey2, etc. map to for a given table. | Property | Value | |---|---| | URL | {base_url}/sys-rest-api/jersey/v2/user-extension/{tableCode} | | Method | GET | | Produces | application/json | | Success Status | 200 OK | | Auth | Basic (Authorization: Basic {credentials}) |
Notes
Authentication and authorization are required.
tableCodeis a path parameter — it goes directly in the URL.whereVariablesaccepts two filter styles — raw field names or genericobjectKeyslots. Both styles can coexist in the same request.When
objectKeyfilters are supplied the endpoint resolves them to authoritative key values by querying the parent base table; raw field-name filters bypass that resolution step.When no rows are found
itemsis omitted and amessagefield is returned instead.masterTableCodeis only populated in the response when at least oneobjectKeyfilter was provided; otherwise it isnull.
UI Navigation
User Extension tables are attached to the parent object's own screen in CMiC. There is no standalone navigation path. Use this endpoint to query data from any UE table by its table code.
Finders / Query Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
tableCode |
Path | Yes | — | UE table code (e.g. CIITEM_K, PROJ_EXT). |
auditDate |
Query | No | — | Return only rows whose UE__IU__CREATE_DATE or UE__IU__UPDATE_DATE is on or after this date. Format must match dateFormat. |
dateFormat |
Query | No | YYYY-MM-DD |
Oracle date format mask used to parse auditDate and any date filter values in whereVariables. |
whereVariables |
Query | No | — | Semicolon-delimited filter pairs: FIELD=VALUE;FIELD=VALUE. Accepts raw frontend field names or generic objectKey1–objectKey10 slot names. |
whereVariables Filter Styles
Style 1 — Raw field names (use exact frontend column names from the UE table):
whereVariables=COMP_CODE=01;ITEM_CODE=BOLT-123
Style 2 — Generic objectKey slots (resolved automatically via key mapping):
whereVariables=objectKey1=01;objectKey2=BOLT-123
Both styles may be combined in one request. When objectKey values are present the endpoint performs a key-validation and resolution round-trip before executing the query.
Attributes
Response Fields
| Field | Type | Description | Example |
|---|---|---|---|
tableCode |
String | The UE table code that was queried | CIITEM_K |
masterTableCode |
String | Parent object table; populated only when objectKey filters were used, otherwise null |
CIITEM |
count |
Integer | Number of rows returned | 2 |
items |
Array | List of row maps; each map is a { "COLUMN_NAME": "value" } object. Omitted when count is 0. |
— |
message |
String | Informational message when no rows are found; omitted when rows are returned | "There is no data in this UE table." |
Examples
Request — filter by raw field names
GET {base_url}/sys-rest-api/jersey/v2/user-extension/CIITEM_K?whereVariables=COMP_CODE=01;ITEM_CODE=BOLT-123
Authorization: Basic {credentials}
Response — 200 OK (rows found)
{
"tableCode": "CIITEM_K",
"masterTableCode": null,
"count": 1,
"items": [
{
"COMP_CODE": "01",
"ITEM_CODE": "BOLT-123",
"UE_CODE1": "STEEL",
"UE_CODE2": "FASTENER",
"UE_NUM1": "12.50",
"UE_DATE1": "2025-01-15"
}
]
}
Request — filter by objectKey slots
GET {base_url}/sys-rest-api/jersey/v2/user-extension/CIITEM_K?whereVariables=objectKey1=01;objectKey2=BOLT-123
Authorization: Basic {credentials}
Response — 200 OK (rows found, objectKey resolution performed)
{
"tableCode": "CIITEM_K",
"masterTableCode": "CIITEM",
"count": 1,
"items": [
{
"COMP_CODE": "01",
"ITEM_CODE": "BOLT-123",
"UE_CODE1": "STEEL",
"UE_CODE2": "FASTENER",
"UE_NUM1": "12.50",
"UE_DATE1": "2025-01-15"
}
]
}
Request — with audit date filter
GET {base_url}/sys-rest-api/jersey/v2/user-extension/CIITEM_K?auditDate=2025-01-01&dateFormat=YYYY-MM-DD
Authorization: Basic {credentials}
Response — 200 OK (no rows found)
{
"tableCode": "CIITEM_K",
"masterTableCode": null,
"count": 0,
"message": "There is no data in this UE table."
}
Error — Invalid Table Code (400)
{
"error": "SD-000376-ERR: Table code 'XYZ' is not valid or the object is not supported."
}
Error — Malformed whereVariables (400)
{
"error": "Filter variable 'BADTOKEN' does not contain '=' delimiter."
}
Error Codes
| HTTP | Error Code | Reason |
|---|---|---|
400 |
SD-000375-ERR |
tableCode path parameter is blank or missing |
400 |
SD-000376-ERR |
Table code does not exist or the parent object is not supported by the UE API |
400 |
— | whereVariables contains a token without an = delimiter |
400 |
— | No key mapping found in ue_master_table_tn for the resolved master table |
500 |
— | Unhandled server error |
Basic authentication
OK
getAllRecords
"{\n \"tableCode\": \"CIITEM_K\",\n \"masterTableCode\": \"CIITEM\",\n \"count\": 20,\n \"items\": [\n {\n \"COMP_CODE\": \"ZZ\",\n \"ITEM_CODE\": \"DIESEL\",\n \"NUMBEROKEY\": \"8\",\n \"AAA\": \"Yash\",\n \"UE__IU__CREATE_DATE\": \"2026-05-28T13:22:25-04:00\",\n \"UE__IU__UPDATE_DATE\": null,\n \"CLTEST\": null\n },\n {\n \"COMP_CODE\": \"ZZ\",\n \"ITEM_CODE\": \"DIESEL\",\n \"NUMBEROKEY\": \"9\",\n \"AAA\": \"Yash\",\n \"UE__IU__CREATE_DATE\": \"2026-05-28T13:22:35-04:00\",\n \"UE__IU__UPDATE_DATE\": null,\n \"CLTEST\": null\n },\n {\n \"COMP_CODE\": \"ZZ\",\n \"ITEM_CODE\": \"DIESEL\",\n \"NUMBEROKEY\": \"20\",\n \"AAA\": \"YashBhavsar@\",\n \"UE__IU__CREATE_DATE\": \"2026-06-22T23:56:15-04:00\",\n \"UE__IU__UPDATE_DATE\": null,\n \"CLTEST\": null\n },\n {\n \"COMP_CODE\": \"ZZ\",\n \"ITEM_CODE\": \"DIESEL\",\n \"NUMBEROKEY\": \"15\",\n \"AAA\": \"YashBhavsar@\",\n \"UE__IU__CREATE_DATE\": \"2026-05-29T11:38:31-04:00\",\n \"UE__IU__UPDATE_DATE\": null,\n \"CLTEST\": null\n },\n {\n \"COMP_CODE\": \"ZZ\",\n \"ITEM_CODE\": \"DIESEL\",\n \"NUMBEROKEY\": \"3\",\n \"AAA\": \"Yash\",\n \"UE__IU__CREATE_DATE\": \"2026-05-27T20:13:27-04:00\",\n \"UE__IU__UPDATE_DATE\": null,\n \"CLTEST\": null\n },\n {\n \"COMP_CODE\": \"ZZ\",\n \"ITEM_CODE\": \"DIESEL\",\n \"NUMBEROKEY\": \"14\",\n \"AAA\": \"YashBhavsar@\",\n \"UE__IU__CREATE_DATE\": \"2026-05-29T11:38:20-04:00\",\n \"UE__IU__UPDATE_DATE\": null,\n \"CLTEST\": null\n },\n {\n \"COMP_CODE\": \"ZZ\",\n \"ITEM_CODE\": \"DIESEL\",\n \"NUMBEROKEY\": \"18\",\n \"AAA\": \"YashBha\",\n \"UE__IU__CREATE_DATE\": \"2026-06-02T12:01:09-04:00\",\n \"UE__IU__UPDATE_DATE\": \"2026-06-23T00:02:11-04:00\",\n \"CLTEST\": null\n },\n {\n \"COMP_CODE\": \"CL02\",\n \"ITEM_CODE\": \"SAND\",\n \"NUMBEROKEY\": \"10\",\n \"AAA\": \"TestValue\",\n \"UE__IU__CREATE_DATE\": \"2026-05-22T14:33:45-04:00\",\n \"UE__IU__UPDATE_DATE\": null,\n \"CLTEST\": \"SomeData\"\n },\n {\n \"COMP_CODE\": \"ZZ\",\n \"ITEM_CODE\": \"DIESEL\",\n \"NUMBEROKEY\": \"19\",\n \"AAA\": \"YashBhavsar@\",\n \"UE__IU__CREATE_DATE\": \"2026-06-03T11:20:28-04:00\",\n \"UE__IU__UPDATE_DATE\": null,\n \"CLTEST\": null\n },\n {\n \"COMP_CODE\": \"ZZ\",\n \"ITEM_CODE\": \"DIESEL\",\n \"NUMBEROKEY\": \"2\",\n \"AAA\": \"Yash\",\n \"UE__IU__CREATE_DATE\": \"2026-05-27T16:48:25-04:00\",\n \"UE__IU__UPDATE_DATE\": null,\n \"CLTEST\": null\n },\n {\n \"COMP_CODE\": \"CL02\",\n \"ITEM_CODE\": \"1010209\",\n \"NUMBEROKEY\": \"1\",\n \"AAA\": \"Carrie\",\n \"UE__IU__CREATE_DATE\": \"2026-05-15T15:07:54-04:00\",\n \"UE__IU__UPDATE_DATE\": null,\n \"CLTEST\": null\n },\n {\n \"COMP_CODE\": \"CL02\",\n \"ITEM_CODE\": \"1010209\",\n \"NUMBEROKEY\": \"2\",\n \"AAA\": \"Test 2\",\n \"UE__IU__CREATE_DATE\": \"2026-05-15T15:07:54-04:00\",\n \"UE__IU__UPDATE_DATE\": null,\n \"CLTEST\": null\n },\n {\n \"COMP_CODE\": \"CL02\",\n \"ITEM_CODE\": \"ACTU0026\",\n \"NUMBEROKEY\": \"1\",\n \"AAA\": \"API Test 1\",\n \"UE__IU__CREATE_DATE\": \"2026-05-15T15:09:39-04:00\",\n \"UE__IU__UPDATE_DATE\": null,\n \"CLTEST\": null\n },\n {\n \"COMP_CODE\": \"CL02\",\n \"ITEM_CODE\": \"ACTU0026\",\n \"NUMBEROKEY\": \"2\",\n \"AAA\": \"API Test 2\",\n \"UE__IU__CREATE_DATE\": \"2026-05-15T15:09:39-04:00\",\n \"UE__IU__UPDATE_DATE\": null,\n \"CLTEST\": null\n },\n {\n \"COMP_CODE\": \"ZZ\",\n \"ITEM_CODE\": \"DIESEL\",\n \"NUMBEROKEY\": \"4\",\n \"AAA\": \"Yash\",\n \"UE__IU__CREATE_DATE\": \"2026-05-27T23:47:32-04:00\",\n \"UE__IU__UPDATE_DATE\": null,\n \"CLTEST\": null\n },\n {\n \"COMP_CODE\": \"ZZ\",\n \"ITEM_CODE\": \"DIESEL\",\n \"NUMBEROKEY\": \"5\",\n \"AAA\": \"Yash\",\n \"UE__IU__CREATE_DATE\": \"2026-05-27T23:47:56-04:00\",\n \"UE__IU__UPDATE_DATE\": null,\n \"CLTEST\": null\n },\n {\n \"COMP_CODE\": \"ZZ\",\n \"ITEM_CODE\": \"DIESEL\",\n \"NUMBEROKEY\": \"6\",\n \"AAA\": \"Yash\",\n \"UE__IU__CREATE_DATE\": \"2026-05-27T23:50:48-04:00\",\n \"UE__IU__UPDATE_DATE\": null,\n \"CLTEST\": null\n },\n {\n \"COMP_CODE\": \"ZZ\",\n \"ITEM_CODE\": \"DIESEL\",\n \"NUMBEROKEY\": \"7\",\n \"AAA\": \"Yash\",\n \"UE__IU__CREATE_DATE\": \"2026-05-27T23:53:22-04:00\",\n \"UE__IU__UPDATE_DATE\": null,\n \"CLTEST\": null\n },\n {\n \"COMP_CODE\": \"ZZ\",\n \"ITEM_CODE\": \"DIESEL\",\n \"NUMBEROKEY\": \"10\",\n \"AAA\": \"YashBhavsar\",\n \"UE__IU__CREATE_DATE\": \"2026-05-28T13:44:26-04:00\",\n \"UE__IU__UPDATE_DATE\": \"2026-05-28T14:09:13-04:00\",\n \"CLTEST\": null\n },\n {\n \"COMP_CODE\": \"ZZ\",\n \"ITEM_CODE\": \"DIESEL\",\n \"NUMBEROKEY\": \"17\",\n \"AAA\": \"YashBhavsar@\",\n \"UE__IU__CREATE_DATE\": \"2026-05-29T18:44:57-04:00\",\n \"UE__IU__UPDATE_DATE\": null,\n \"CLTEST\": null\n }\n ],\n \"message\": null\n}"getSpecificRecord
"{\n \"tableCode\": \"POSUMM\",\n \"masterTableCode\": \"POSUMMARY\",\n \"count\": 1,\n \"items\": [\n {\n \"POPF1\": \"yash\",\n \"POPF2\": null,\n \"UE__IU__CREATE_DATE\": \"2026-06-25T14:06:38-04:00\",\n \"UE__IU__UPDATE_DATE\": null\n }\n ],\n \"message\": null\n}"