View a Scope Item by Code
get
/primeapi/restapi/scopeItem/code/{code}
This endpoint returns scope items that meet the following requirements:
- The object has a code that matches the value of the {code} path parameter.
Request
Path Parameters
-
code: string
The user-specified identifier of a scope item.
Response
Supported Media Types
- application/json
200 Response
successful operation
Nested Schema : ApiEntityScopeItem
Type:
Show Source
object
-
approvedChangedHours:
object Hour
-
approvedChangedUnits:
object Quantity
-
assignedHours:
object Hour
-
assignedUnits:
object Quantity
-
atCompletionUnits:
object Quantity
-
baselineHours:
object Hour
-
baselineUnits:
object Quantity
-
costSheetItemId(optional):
integer(int64)
The cost breakdown structure code assigned to the scope item.
-
currentHoursPerUnit(optional):
number(double)
The number of hours required to install a single quantity of the scope item material or product based on current values.
For example, if the product is 1,000 feet of cable it may be estimated to take 2 hours install one foot of cable.
This field is recalculated if Current Hours are changed. -
description:
string
Allowed Values:
[ "Length[0-4000]" ]
Details describing the scope item. -
effectiveFinish(optional):
string(date-time)
The latest Effective Finish date for Actual to Date values of all scope item's scope assignments.
-
effectiveStart(optional):
string(date-time)
The earliest Effective Start date for Actual to Date values of all the scope item's scope assignments.
-
etcAdjustedUnits:
object Quantity
-
itemCode(optional):
string
Allowed Values:
[ "Length[1-60]" ]
The unique identifier for the scope item. -
itemCodeUpper(optional):
string
Allowed Values:
[ "Length[1-60]" ]
The code of an upper scope item. -
itemName(optional):
string
Allowed Values:
[ "Length[1-255]" ]
The name of the scope item. -
itemNameUpper(optional):
string
Allowed Values:
[ "Length[1-255]" ]
The name of an upper scope item. -
link(optional):
string(url)
Read Only:
true
-
pbsId(optional):
integer(int64)
The parent PBS for the scope item.
-
pendingChangedHours:
object Hour
-
pendingChangedUnits:
object Quantity
-
percentComplete:
object Percent
-
plannedHours(optional):
object Hour
-
plannedHoursPerUnit(optional):
number(double)
The number of hours required to install or assemble a single quantity of the scope item material or product.
For example, if the product is 1,000 feet of cable it may be estimated to take 2 hours install one foot of cable.
Calculated as Original Hours divided by Original Quantity. -
plannedUnits(optional):
object Quantity
-
projectId(optional):
integer(int64)
The ID for the project where the scope item exists.
-
remainingUnits:
object Quantity
-
revisedHours:
object Hour
-
revisedUnits:
object Quantity
-
scopeItemCodeValue(optional):
array scopeItemCodeValue
Unique Items Required:
true
A code value object. -
scopeItemConfiguredFields(optional):
object ApiEntityScopeItemConfiguredFields
-
scopeItemId(optional):
integer(int64)
-
status(optional):
string
Allowed Values:
[ "PENDING", "APPROVED", "REJECTED" ]
The state of the scope item in the change request. -
unAssignedHours:
object Hour
-
unAssignedUnits:
object Quantity
-
unitOfMeasureId:
integer(int64)
The name of the measurement type used to describe the quantity of a scope item.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
Nested Schema : Quantity
Type:
object
Nested Schema : scopeItemCodeValue
Type:
array
Unique Items Required:
true
A code value object.
Show Source
Nested Schema : ApiEntityScopeItemConfiguredFields
Type:
Show Source
object
-
costFlexMap(optional):
object costFlexMap
Additional Properties Allowed: additionalPropertiesAn object containing cost fields in the form of key-value pairs.
-
link(optional):
string(url)
Read Only:
true
-
otherFlexMap(optional):
object otherFlexMap
Additional Properties Allowed: additionalPropertiesAn object containing non-cost and non-text fields in the form of key-value pairs.
-
primaryKey(optional):
integer(int64)
-
scopeItem(optional):
object ApiEntityScopeItem
-
scopeItemId(optional):
integer(int64)
The system-generated identifier of a scope item.
-
textFlexMap(optional):
object textFlexMap
Additional Properties Allowed: additionalPropertiesAn object containing text fields in the form of key-value pairs.
-
uniqueName(optional):
string
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
Nested Schema : ApiEntityCodeValueScopeItem
Type:
Show Source
object
-
codeType(optional):
object ApiEntityCodeType
-
codeValue(optional):
object ApiEntityCodeValue
-
codeValueScopeItemId(optional):
integer(int64)
The unique identifier for the code value assigned to the scope item.
-
link(optional):
string(url)
Read Only:
true
-
scopeItemId(optional):
integer(int64)
The unique identifier of a scope item.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
Nested Schema : ApiEntityCodeType
Type:
Show Source
object
-
assignments(optional):
array assignments
Unique Items Required:
true
CodeType assignments. -
codeTypeCode:
string
Allowed Values:
[ "Length[1-40]" ]
This field displays the name of a code or value. -
codeTypeId(optional):
integer(int64)
The system-generated identifier of a code type.
-
codeTypeName:
string
Allowed Values:
[ "Length[1-40]" ]
The name of a code or value. -
link(optional):
string(url)
Read Only:
true
-
pushDownType:
string
Allowed Values:
[ "MANUAL", "AUTOMATIC" ]
The push down type of the workspace code. -
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response. -
workspace:
integer(int64)
The ID of the owning workspace.
Nested Schema : ApiEntityCodeValue
Type:
Show Source
object
-
codeTypeId:
integer(int64)
The ID for the code type.
-
codeTypeName:
string
The name of a code or value.
-
codeValueCode:
string
Allowed Values:
[ "LENGTH[1-32]" ]
The unique identifier for the code value. -
codeValueId(optional):
integer(int64)
The unique identifier for the code value.
-
codeValueName:
string
Allowed Values:
[ "LENGTH[1-100]" ]
The name of the code value. -
link(optional):
string(url)
Read Only:
true
-
parentCodeValue(optional):
integer(int64)
The parent code value.
-
sequenceNumber:
integer(int32)
The number that specifies the position of the code value item within the code type list.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
Nested Schema : assignments
Type:
array
Unique Items Required:
true
CodeType assignments.
Show Source
Nested Schema : ApiEntityCodeEntityType
Type:
Show Source
object
-
codeType:
object ApiEntityCodeType
-
entityType:
string
Allowed Values:
[ "SCOPE_ITEM", "PROJECT", "SCOPE_ASSIGNMENT", "WBS", "WORK_PACKAGE", "ACTIVITY", "RESOURCE", "PBS", "CONTRACT", "RISK", "COMMITMENT", "REPORT", "TASKS", "STRATEGY", "PORTFOLIO", "FUND", "SUBMITTAL", "CHANGE_ORDER", "PAYMENT_APPLICATION", "CHANGE_EVENT", "CHANGES_ESTIMATES", "IDEA", "RFI", "CUSTOM_LOG_ITEM" ]
Indicates the type of object the code is associated to. -
link(optional):
string(url)
Read Only:
true
-
primaryKey:
integer(int64)
The unique identifier of a code type table.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
Nested Schema : costFlexMap
Type:
object
Additional Properties Allowed
Show Source
An object containing cost fields in the form of key-value pairs.
Nested Schema : otherFlexMap
Type:
object
Additional Properties Allowed
Show Source
An object containing non-cost and non-text fields in the form of key-value pairs.
Nested Schema : textFlexMap
Type:
object
Additional Properties Allowed
Show Source
An object containing text fields in the form of key-value pairs.
Nested Schema : additionalProperties
Type:
object
Nested Schema : additionalProperties
Type:
object
Nested Schema : additionalProperties
Type:
object
204 Response
Successful operation with no content.
404 Response
The requested scope item does not exist, or you do not have access to it.