View a Submittal by Project Code and Workspace Code
get
/primeapi/restapi/submittal/workspace/{worksaceCode}/project/{projectCode}
This endpoint returns submittals that meet the following requirements:
- The object is associated with a project with a code value that matches the value of the {projectCode} path parameter.
- The object is associated with a workspace with a code value that matches the value of the {workspaceCode} path parameter.
Request
Path Parameters
-
projectCode: string
The user-specified identifier of a project.
-
worksaceCode: string
The user-specified identifier of a workspace.
Response
Supported Media Types
- application/json
200 Response
successful operation
Nested Schema : ApiEntitySubmittal
Type:
Show Source
object
-
approvalComment(optional):
string
Additional information about the submittal.
-
approvedDate(optional):
object TimezoneSensitiveDateTime
-
approvingCompanyId(optional):
integer(int64)
Read Only:
true
The company related to the user who approved the submittal. -
approvingCompanyName(optional):
string
Read Only:
true
Name of the approvedBy Company that has to be assigned to the project and Submittals. -
approvingCompanyPostalCode(optional):
string
Read Only:
true
PostalCode of the approvedBy Company that has to be assigned to the project and Submittals. -
approvingUserId(optional):
integer(int64)
Read Only:
true
The user who will approve the submittal. -
approvingUserName(optional):
string
UserName of the approvedBy user, that has to be assigned to submittal.
-
ballInCourtId(optional):
integer(int64)
Read Only:
true
The user who is responsible for the submittal. -
codeValues(optional):
array codeValues
Unique Items Required:
true
The categories assigned to a submittal. -
coordinatingCompanyId(optional):
integer(int64)
The company associated with the user who is responsible for reviewing detailed work documents.
-
coordinatingCompanyName(optional):
string
Name of the coordinating Company that has to be assigned to the project and Submittals.
-
coordinatingCompanyPostalCode(optional):
string
PostalCode of the coordinating Company that has to be assigned to the project and Submittals.
-
coordinatingUserId(optional):
integer(int64)
The user who is responsible for reviewing detailed work documents.
-
coordinatingUserName(optional):
string
UserName of the coordinating user, that has to be assigned to submittal.
-
dateCreated(optional):
object TimezoneSensitiveDateTime
-
description(optional):
string
Detailed information about the submittal.
-
dueDate(optional):
string(date-time)
The date by which the submittal must be approved.
-
dueDateChanged(optional):
boolean
Read Only:
true
Indicates whether or not the due date changed. -
flowType(optional):
string
The flow type of a submittal.
-
isCustomWorkflowInProgress(optional):
boolean
Read Only:
true
Indicates whether or not a custom workflow is in progress on the submittal. -
isProjectCompanyExists(optional):
boolean
Read Only:
true
Indicates whether or not an assocaited project company exists. -
itemCode(optional):
string
A unique identifier for the submittal.
-
itemPrefix(optional):
string
The prefix of the unique identifier of a submittal.
-
itemSuffix(optional):
integer(int64)
The suffix of the unique identifier of a submittal.
-
link(optional):
string(url)
Read Only:
true
-
materialDeliveryDate(optional):
string(date-time)
The date by which materials must be delivered.
-
priority(optional):
string
Allowed Values:
[ "HIGH", "MEDIUM", "NORMAL", "LOW" ]
The submittal's level of importance. Priority can be set to High, Medium, Normal, or Low. -
projectCode(optional):
string
Project Code of the project, which the Submittal is part of.
-
projectId:
integer(int64)
The system-generated identifier of a project.
-
requiredAction(optional):
string
Allowed Values:
[ "SUBMIT", "REVIEW", "ASSIGN", "FINAL_REVIEW", "NONE", "SUBMIT_REVISION", "RESUBMIT", "SET_AS_DRAFT", "REQUEST_REVISION", "REJECTED" ]
Indicates whether the submittal requires an action from a user. -
reviewedBy(optional):
string
The user who officially approved the submittal.
-
revisionNo(optional):
string
Read Only:
true
This number is automatically generated and based on values in the submittal's Revision fields. -
sendNotification(optional):
boolean
Indicates whether or not changes to the submittal distribute notifications.
-
specSectionId:
integer(int64)
The spec section's ID and title.
-
specSectionNumber(optional):
string
SpecSectionNumber of the spec section, which submittal is part of.
-
status(optional):
string
Allowed Values:
[ "DRAFT", "PENDING_REVIEW", "PENDING_APPROVAL", "REJECTED", "APPROVED", "APPROVED_AS_NOTED", "REVISION_NEEDED", "CANCELED" ]
The status of the submittal. Available Status values include Draft, Pending Review, Pending Approval, Revision Needed, Rejected, Approved, Approved as Noted, and Canceled. -
submitByDate(optional):
string(date-time)
Read Only:
true
The date when the submittal is due by the subcontractor. -
submitByDateChanged(optional):
boolean
Read Only:
true
Indicates whether or not the submit by date has changed. -
submittalConfiguredFields(optional):
object ApiEntitySubmittalConfiguredFields
-
submittalId(optional):
integer(int64)
A unique identifier for the submittal.
-
submittalName:
string
The name of the submittal.
-
submittingCompanyId(optional):
integer(int64)
The company associated with the user who is responsible for uploading the submittal document.
-
submittingCompanyName(optional):
string
Read Only:
true
Name of the submitting Company that has to be assigned to the project and Submittals. -
submittingCompanyPostalCode(optional):
string
PostalCode of the submitting Company that has to be assigned to the project and Submittals.
-
submittingUserId(optional):
integer(int64)
The user who is responsible for uploading the submittal document.
-
submittingUserName(optional):
string
The username of the user that submitted the submittal.
-
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. -
workspaceCode(optional):
string
Workspace Code of the workspace, which the project containing the Submittal is part of.
Nested Schema : codeValues
Type:
array
Unique Items Required:
true
The categories assigned to a submittal.
Show Source
Nested Schema : ApiEntitySubmittalConfiguredFields
Type:
Show Source
object
-
costFlexMap(optional):
object costFlexMap
Additional Properties Allowed: additionalPropertiesCost fields assigned to the Submittal with its corresponding value as a (key,value) pair.
-
link(optional):
string(url)
Read Only:
true
-
otherFlexMap(optional):
object otherFlexMap
Additional Properties Allowed: additionalPropertiesOther fields assigned to the Submittal with its corresponding value as a (key,value) pair.
-
textFlexMap(optional):
object textFlexMap
Additional Properties Allowed: additionalPropertiesText fields assigned to the Submittal with its corresponding value as a (key,value) pair.
-
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 : ApiEntityCodeValueSubmittal
Type:
Show Source
object
-
codeType(optional):
object ApiEntityCodeType
-
codeValue(optional):
object ApiEntityCodeValue
-
codeValueSubmittalId(optional):
integer(int64)
The system-generated identifier of a submittal.
-
link(optional):
string(url)
Read Only:
true
-
submittalId(optional):
integer(int64)
The system-generated identifier of a submittal.
-
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
Cost fields assigned to the Submittal with its corresponding value as a (key,value) pair.
Nested Schema : otherFlexMap
Type:
object
Additional Properties Allowed
Show Source
Other fields assigned to the Submittal with its corresponding value as a (key,value) pair.
Nested Schema : textFlexMap
Type:
object
Additional Properties Allowed
Show Source
Text fields assigned to the Submittal with its corresponding value as a (key,value) pair.
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 object does not exist, or you do not have access to it.