Read a list of all completed projects for the given ID. PM
id
globally unique identifier
Required
Guid ID of the organization, department or individual for the project. |
period
integer
Optional period ID filter. Defaults to the current period. |
tz
string
Optional parameter to set time zone information. |
None.
ID
globally unique identifier
Required on Update
ID of the project. |
ParentID
globally unique identifier
ID of the parent. |
AncestorID
globally unique identifier
Required
Ancestor ID of the project; organization or department.. |
Rank
integer
Rank of the project. |
Color
string
Hex value of the color for the project. (Max length 6 characters) |
HoursActual
decimal number
(Deprecated) Number of hours this project actually took to complete. |
HoursProjected
decimal number
(Deprecated) Number of hours this project is projected to take. |
StartDateActual
string
Actual start date of the project. |
StartDateProjected
string
Projected start date of the project. |
EndDateActual
string
Date the project actually ended. |
EndDateProjected
string
Date the project is projected to end. |
TrackingLabel
string
Customizable label for project. |
NearHighlightOverride
integer
Near due highlight settings for a given project that have been overridden at the project level. |
Name
string
Name of the given project. (Max length 255 characters) |
Description
string
Description of the project. |
StatusID
integer
ID of the status linked to this project. |
PhaseID
integer
Required
ID of the phase linked to this project. |
AncestorName
string
ReadOnly
Ancestor Name of the project; department or organization. |
RankOrder
string
ReadOnly
RankOrder to sort rank in the format .0001.0001.0001 |
DisplayRank
string
ReadOnly
Rank that is displayed |
Level
integer
ReadOnly
Number of indent levels, Ex: 1 = 1, 1.1 = 2, 1.1.1 = 3 |
SumHoursActual
decimal number
ReadOnly
Sum of all the hours spent on this project. |
SumHoursProjected
decimal number
ReadOnly
Sum of the projected number of hours to be spent on this project. |
Status
string
ReadOnly
Name of the status linked to this project. |
Phase
string
ReadOnly
Name of the phase linked to this project. |
Deleted
boolean
ReadOnly
Deleted status of this project. |
DeletedByRef
boolean
ReadOnly
Deleted by reference status of this project. |
Created
string
ReadOnly
Date the project was created. |
CreatedBy
globally unique identifier
ReadOnly
ID of the person that created the project. |
Updated
date
ReadOnly
Date the given project was last updated. |
UpdatedBy
globally unique identifier
ReadOnly
ID of the person that last updated the given project. |
TeamMembers
string
ReadOnly
Individuals assigned to the project as team members. |
LastComment
string
ReadOnly
Last comment made on this project. |
LastCommentDate
date
ReadOnly
Date the last comment was made. |
LastCommentByID
globally unique identifier
ReadOnly
ID of the person that made the last comment. |
LastCommentBy
string
ReadOnly
Name of the person that last commented. |
EndDateChanges
integer
ReadOnly
Number of times the end date has changed for the project. |
IncludeSurveys
boolean
ReadOnly
Parameter to include or omit surveys. |
AncestorType
integer
ReadOnly
AncestorType of the project. |
Draft
boolean
Indicates if the given project is a draft, this defaults to false. (drafts are unfinished projects that are only visible to the person that created them and not public). |
LinkedToID
globally unique identifier
ReadOnly
ID of the linked project. |
TeamMemberList
Collection of TeamMember
ReadOnly
List and details of Team Members for a given project. |
StatusName
string
ReadOnly
Name of the status for the given project. |
StatusRank
integer
ReadOnly
Rank of the status for the given project. |
PhaseName
string
ReadOnly
Name of the phase for the given project. |
PhaseRank
integer
ReadOnly
Rank of the phase for the given project. |
ColorName
string
ReadOnly
Name of the color for the given project. |
ColorRank
integer
ReadOnly
Rank of the color for the given project. |
LinkedAncestorID
globally unique identifier
ReadOnly
Ancestor ID of the linked project. |
LinkedToName
string
ReadOnly
Name of the linked project. |
LinkedToRowType
integer
ReadOnly
RowType of the linked project. |
LinkedAncestorName
string
ReadOnly
Name of the linked Ancestor. |
EndDate
string
ReadOnly
Actual end date of the project, if it is not set then projected end date of the project. |
StartDate
string
ReadOnly
Actual start date of the project, if it is not set then the projected start date of the given project. |
RowType
integer
ReadOnly
Row type of the given project. |
RankPath
Collection of byte
ReadOnly
Current rank of the given project in a byte array. |
OnTime
boolean
ReadOnly
Indicates the on time status of the project, by comparing the actual and projected end dates. |
CanRead
boolean
ReadOnly
Read permission of the given project for the currently logged in individual. |
CanUpdate
boolean
ReadOnly
Update permission of the given project for the currently logged in individual. |
CanDelete
boolean
ReadOnly
Delete permission of the given project for the currently logged in individual. |
CanDelegate
boolean
ReadOnly
Delegate permission of the given project for the currently logged in individual. |
NearHighlight
integer
Required
Near due highlight settings for a given project that have not been overridden. |
<Project xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4"> <ID>d3f89312-4a8f-44a9-8ed4-3b5c1f18fbd6</ID> <ParentID>1bc07555-d2ed-4c16-8b85-23a6965f3070</ParentID> <AncestorID>014f2186-88d0-4879-9f0f-ba33c9e94bcb</AncestorID> <Rank>1</Rank> <Color>sample string 1</Color> <HoursActual>1</HoursActual> <HoursProjected>1</HoursProjected> <TrackingLabel>sample string 6</TrackingLabel> <NearHighlightOverride>1</NearHighlightOverride> <Name>sample string 7</Name> <Description>sample string 8</Description> <StatusID>1</StatusID> <PhaseID>1</PhaseID> <AncestorName>sample string 9</AncestorName> <RankOrder>sample string 10</RankOrder> <DisplayRank>sample string 11</DisplayRank> <Level>1</Level> <SumHoursActual>1</SumHoursActual> <SumHoursProjected>1</SumHoursProjected> <Status>sample string 12</Status> <Phase>sample string 13</Phase> <Deleted>true</Deleted> <DeletedByRef>true</DeletedByRef> <Created>sample string 14</Created> <CreatedBy>ebf499dd-259a-4c95-a498-75e912041796</CreatedBy> <Updated>2025-04-10T03:29:28.6088456+00:00</Updated> <UpdatedBy>58d6f5a0-c7b1-4b4f-81c4-4dacdbdd9de5</UpdatedBy> <TeamMembers>sample string 15</TeamMembers> <LastComment>sample string 16</LastComment> <LastCommentDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System"> <d2p1:DateTime>2025-04-10T03:29:28.6088456Z</d2p1:DateTime> <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes> </LastCommentDate> <LastCommentByID>59f76dcb-28b5-453a-964e-2d12961e4330</LastCommentByID> <LastCommentBy>sample string 17</LastCommentBy> <EndDateChanges>1</EndDateChanges> <IncludeSurveys>true</IncludeSurveys> <AncestorType>1</AncestorType> <Draft>true</Draft> <LinkedToID>f493c86b-35a7-4c9f-9c71-37e79b38e956</LinkedToID> <TeamMemberList> <TeamMember> <TaskID>f89d09c9-73ff-4ad8-bfe2-b21e8b9b3527</TaskID> <IndividualID>1c844929-f406-4f3b-b175-6387c2dbe473</IndividualID> <RoleID>e1b2dd85-8a3e-432f-8826-bb173ebd8d77</RoleID> <HoursProjected>1</HoursProjected> <HoursActual>1</HoursActual> <ID>b221a72f-ed2c-4bae-a619-b96d6c132c4e</ID> <RoleName>sample string 1</RoleName> <HoursActualRollup>1</HoursActualRollup> <HoursProjectedRollup>1</HoursProjectedRollup> <IndividualFullName>sample string 2</IndividualFullName> <Created>2025-04-10T03:29:28.6088456+00:00</Created> <CreatedBy>8c1cfc72-78f4-4fe9-a26a-f62f9c149aef</CreatedBy> <SiteID>ca06da53-4d14-4976-8e9f-eb891e1a6208</SiteID> <Updated>2025-04-10T03:29:28.6088456+00:00</Updated> <UpdatedBy>03ad3d79-31c6-4e70-bc89-8e42dc2f4d1a</UpdatedBy> <IndividualFullOrderedName>sample string 3</IndividualFullOrderedName> <RoleDescription>sample string 4</RoleDescription> <TeamSurvey>true</TeamSurvey> </TeamMember> <TeamMember> <TaskID>f89d09c9-73ff-4ad8-bfe2-b21e8b9b3527</TaskID> <IndividualID>1c844929-f406-4f3b-b175-6387c2dbe473</IndividualID> <RoleID>e1b2dd85-8a3e-432f-8826-bb173ebd8d77</RoleID> <HoursProjected>1</HoursProjected> <HoursActual>1</HoursActual> <ID>b221a72f-ed2c-4bae-a619-b96d6c132c4e</ID> <RoleName>sample string 1</RoleName> <HoursActualRollup>1</HoursActualRollup> <HoursProjectedRollup>1</HoursProjectedRollup> <IndividualFullName>sample string 2</IndividualFullName> <Created>2025-04-10T03:29:28.6088456+00:00</Created> <CreatedBy>8c1cfc72-78f4-4fe9-a26a-f62f9c149aef</CreatedBy> <SiteID>ca06da53-4d14-4976-8e9f-eb891e1a6208</SiteID> <Updated>2025-04-10T03:29:28.6088456+00:00</Updated> <UpdatedBy>03ad3d79-31c6-4e70-bc89-8e42dc2f4d1a</UpdatedBy> <IndividualFullOrderedName>sample string 3</IndividualFullOrderedName> <RoleDescription>sample string 4</RoleDescription> <TeamSurvey>true</TeamSurvey> </TeamMember> </TeamMemberList> <StatusName>sample string 18</StatusName> <StatusRank>1</StatusRank> <PhaseName>sample string 19</PhaseName> <PhaseRank>1</PhaseRank> <ColorName>sample string 20</ColorName> <ColorRank>1</ColorRank> <LinkedAncestorID>c81503e2-d226-4a02-ac42-6be9b516ed3a</LinkedAncestorID> <LinkedToName>sample string 21</LinkedToName> <LinkedToRowType>1</LinkedToRowType> <LinkedAncestorName>sample string 22</LinkedAncestorName> <RowType>1</RowType> <RankPath>QEA=</RankPath> <OnTime>true</OnTime> <CanRead>true</CanRead> <CanUpdate>true</CanUpdate> <CanDelete>true</CanDelete> <CanDelegate>true</CanDelegate> <NearHighlight>1</NearHighlight> </Project>
{ "ID": "d3f89312-4a8f-44a9-8ed4-3b5c1f18fbd6", "ParentID": "1bc07555-d2ed-4c16-8b85-23a6965f3070", "AncestorID": "014f2186-88d0-4879-9f0f-ba33c9e94bcb", "Rank": 1, "Color": "sample string 1", "HoursActual": 1.0, "HoursProjected": 1.0, "TrackingLabel": "sample string 6", "NearHighlightOverride": 1, "Name": "sample string 7", "Description": "sample string 8", "StatusID": 1, "PhaseID": 1, "AncestorName": "sample string 9", "RankOrder": "sample string 10", "DisplayRank": "sample string 11", "Level": 1, "SumHoursActual": 1.0, "SumHoursProjected": 1.0, "Status": "sample string 12", "Phase": "sample string 13", "Deleted": true, "DeletedByRef": true, "Created": "sample string 14", "CreatedBy": "ebf499dd-259a-4c95-a498-75e912041796", "Updated": "2025-04-10T03:29:28.6088456+00:00", "UpdatedBy": "58d6f5a0-c7b1-4b4f-81c4-4dacdbdd9de5", "TeamMembers": "sample string 15", "LastComment": "sample string 16", "LastCommentDate": "2025-04-10T03:29:28.6088456+00:00", "LastCommentByID": "59f76dcb-28b5-453a-964e-2d12961e4330", "LastCommentBy": "sample string 17", "EndDateChanges": 1, "IncludeSurveys": true, "AncestorType": 1, "Draft": true, "LinkedToID": "f493c86b-35a7-4c9f-9c71-37e79b38e956", "TeamMemberList": [ { "TaskID": "f89d09c9-73ff-4ad8-bfe2-b21e8b9b3527", "IndividualID": "1c844929-f406-4f3b-b175-6387c2dbe473", "RoleID": "e1b2dd85-8a3e-432f-8826-bb173ebd8d77", "HoursProjected": 1.0, "HoursActual": 1.0, "ID": "b221a72f-ed2c-4bae-a619-b96d6c132c4e", "RoleName": "sample string 1", "HoursActualRollup": 1.0, "HoursProjectedRollup": 1.0, "IndividualFullName": "sample string 2", "Created": "2025-04-10T03:29:28.6088456+00:00", "CreatedBy": "8c1cfc72-78f4-4fe9-a26a-f62f9c149aef", "SiteID": "ca06da53-4d14-4976-8e9f-eb891e1a6208", "Updated": "2025-04-10T03:29:28.6088456+00:00", "UpdatedBy": "03ad3d79-31c6-4e70-bc89-8e42dc2f4d1a", "IndividualFullOrderedName": "sample string 3", "RoleDescription": "sample string 4", "TeamSurvey": true }, { "TaskID": "f89d09c9-73ff-4ad8-bfe2-b21e8b9b3527", "IndividualID": "1c844929-f406-4f3b-b175-6387c2dbe473", "RoleID": "e1b2dd85-8a3e-432f-8826-bb173ebd8d77", "HoursProjected": 1.0, "HoursActual": 1.0, "ID": "b221a72f-ed2c-4bae-a619-b96d6c132c4e", "RoleName": "sample string 1", "HoursActualRollup": 1.0, "HoursProjectedRollup": 1.0, "IndividualFullName": "sample string 2", "Created": "2025-04-10T03:29:28.6088456+00:00", "CreatedBy": "8c1cfc72-78f4-4fe9-a26a-f62f9c149aef", "SiteID": "ca06da53-4d14-4976-8e9f-eb891e1a6208", "Updated": "2025-04-10T03:29:28.6088456+00:00", "UpdatedBy": "03ad3d79-31c6-4e70-bc89-8e42dc2f4d1a", "IndividualFullOrderedName": "sample string 3", "RoleDescription": "sample string 4", "TeamSurvey": true } ], "StatusName": "sample string 18", "StatusRank": 1, "PhaseName": "sample string 19", "PhaseRank": 1, "ColorName": "sample string 20", "ColorRank": 1, "LinkedAncestorID": "c81503e2-d226-4a02-ac42-6be9b516ed3a", "LinkedToName": "sample string 21", "LinkedToRowType": 1, "LinkedAncestorName": "sample string 22", "RowType": 1, "RankPath": "QEA=", "OnTime": true, "CanRead": true, "CanUpdate": true, "CanDelete": true, "CanDelegate": true, "NearHighlight": 1 }