Back

GET individuals/{id}?tz={tz}

Read an individual.

Request Information

URI Parameters

System.Collections.ObjectModel.Collection`1[Connections.API.Areas.HelpPage.ModelDescriptions.ParameterDescription] IList
id globally unique identifier Required

Guid ID of the individual to be read
tz string

Optional parameter to set time zone information.

Body Parameters

None.

Response Information

Resource Description (Individual)

System.Collections.ObjectModel.Collection`1[Connections.API.Areas.HelpPage.ModelDescriptions.ParameterDescription] IList
ID globally unique identifier Required on Update

ID of the given individual.
SiteID globally unique identifier ReadOnly

ID of the site for the given individual.
IsAdmin boolean

Administrator setting for the given individual.
UserID globally unique identifier ReadOnly

User ID of the given individual.
Prefix string

Prefix of the given individual's name. (Max length 25 characters)
Suffix string

Suffix of the given individual's name. (Max length 25 characters)
FirstName string Required

First name of the given individual. (Max length 50 characters)
LastName string Required

Last name of the given individual. (Max length 50 characters)
UserDefined1 string

User defined field one. (Max length 255 characters)
UserDefined2 string

User defined field two. (Max length 255 characters)
UserDefined3 string

User defined field three. (Max length 255 characters)
UserDefined4 string

User defined field four. (Max length 255 characters)
Email string Required on Create

Email address of the given individual. (Max length 255 characters)
PrimaryOrganizationID globally unique identifier Required on Create

ID of the primary organization of the given individual.
PrimaryTitle string Required on Create

Title of the given individual. (Max length 255 characters)
PrimaryReportsTo globally unique identifier Required on Create

ID of the primary reports to person for the given individual.
UserName string Required

User name of the given individual. (Max length 255 characters)
Password string

Password of the given individual(Used for create and update). (This varible has been Deprecated and may be removed at a later date.)
ParentID globally unique identifier Required on Create

Deprecated, this is no longer used and is always null.
PrimaryOrganizationName string ReadOnly

Name of the primary organization for the given individual.
FullName string ReadOnly

Full name of the given individual.
FormalName string ReadOnly

Formal name of the given individual.
FullOrderedName string ReadOnly

Full ordered name of the given individual.
Deleted boolean ReadOnly

Deleted status of the given individual.
DeletedByRef boolean ReadOnly

Deleted by reference status of the given individual.
Created date ReadOnly

Date the given individual was created.
CreatedBy globally unique identifier ReadOnly

ID of the person that created the given individual.
Updated date ReadOnly

Date the given individual was last updated.
UpdatedBy globally unique identifier ReadOnly

ID of the person that last updated the given individual.
IsGlobalAdmin boolean ReadOnly

Global administrator setting for the given individual.
UserEmail string Required on Create

User email address of the given individual. (This varible has been Deprecated and may be removed at a later date.)
LastComment string ReadOnly

Body of the most recent comment for the given individual.
LastCommentDate date ReadOnly

Date of the most recent comment for the given individual.
LastCommentByID globally unique identifier ReadOnly

ID of the individual who created the most recent comment for the given individual.
LastCommentBy string ReadOnly

Name of the individual who created the most recent comment for the given individual.
CanRead boolean ReadOnly

Read security setting for the individual based on the current logged in user.
CanUpdate boolean ReadOnly

Update security setting for the individual based on the current logged in user.
CanDelete boolean ReadOnly

Delete security setting for the individual based on the current logged in user.
CanDelegate boolean ReadOnly

Delegate security setting for the individual based on the current logged in user.
SendEvalSurvey boolean ReadOnly

Send Individual Evaluation Surveys
HireDate date

Date the given Individual was hired.

Response Formats

application/xml, text/xml

Sample
<Individual xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <ID>a977167d-5551-42d9-a2fa-40a0ce9215f5</ID>
  <SiteID>c39edfe8-167b-4333-975d-f168066d43ab</SiteID>
  <IsAdmin>true</IsAdmin>
  <UserID>c44d4ad0-b7e2-435c-918a-5be9a5be198f</UserID>
  <Prefix>sample string 1</Prefix>
  <Suffix>sample string 2</Suffix>
  <FirstName>sample string 3</FirstName>
  <LastName>sample string 4</LastName>
  <UserDefined1>sample string 5</UserDefined1>
  <UserDefined2>sample string 6</UserDefined2>
  <UserDefined3>sample string 7</UserDefined3>
  <UserDefined4>sample string 8</UserDefined4>
  <Email>sample string 9</Email>
  <PrimaryOrganizationID>da5f006f-86a9-452a-9483-25293e572a3a</PrimaryOrganizationID>
  <PrimaryTitle>sample string 10</PrimaryTitle>
  <PrimaryReportsTo>c058da72-9ddb-477d-8d40-54d9935a5846</PrimaryReportsTo>
  <UserName>sample string 11</UserName>
  <Password>sample string 12</Password>
  <ParentID>7ff6cc40-5639-4eac-a062-98d259ae7379</ParentID>
  <PrimaryOrganizationName>sample string 13</PrimaryOrganizationName>
  <FullName>sample string 14</FullName>
  <FormalName>sample string 15</FormalName>
  <FullOrderedName>sample string 16</FullOrderedName>
  <Deleted>true</Deleted>
  <DeletedByRef>true</DeletedByRef>
  <Created>2025-03-06T22:05:01.8423547+00:00</Created>
  <CreatedBy>95f59a45-99eb-4e0a-9fa9-704fac0b0e3f</CreatedBy>
  <Updated>2025-03-06T22:05:01.8423547+00:00</Updated>
  <UpdatedBy>6b976f8b-21f1-4501-a68a-1d6ae9ae5d2a</UpdatedBy>
  <IsGlobalAdmin>true</IsGlobalAdmin>
  <UserEmail>sample string 19</UserEmail>
  <LastComment>sample string 20</LastComment>
  <LastCommentDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2025-03-06T22:05:01.8423547Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </LastCommentDate>
  <LastCommentByID>f6961771-e2f1-417c-b87b-8609205d45bf</LastCommentByID>
  <LastCommentBy>sample string 21</LastCommentBy>
  <CanRead>true</CanRead>
  <CanUpdate>true</CanUpdate>
  <CanDelete>true</CanDelete>
  <CanDelegate>true</CanDelegate>
  <SendEvalSurvey>true</SendEvalSurvey>
  <HireDate>2025-03-06T22:05:01.8423547+00:00</HireDate>
</Individual>

application/json, text/json

Sample
{
  "ID": "a977167d-5551-42d9-a2fa-40a0ce9215f5",
  "SiteID": "c39edfe8-167b-4333-975d-f168066d43ab",
  "IsAdmin": true,
  "UserID": "c44d4ad0-b7e2-435c-918a-5be9a5be198f",
  "Prefix": "sample string 1",
  "Suffix": "sample string 2",
  "FirstName": "sample string 3",
  "LastName": "sample string 4",
  "UserDefined1": "sample string 5",
  "UserDefined2": "sample string 6",
  "UserDefined3": "sample string 7",
  "UserDefined4": "sample string 8",
  "Email": "sample string 9",
  "PrimaryOrganizationID": "da5f006f-86a9-452a-9483-25293e572a3a",
  "PrimaryTitle": "sample string 10",
  "PrimaryReportsTo": "c058da72-9ddb-477d-8d40-54d9935a5846",
  "UserName": "sample string 11",
  "Password": "sample string 12",
  "ParentID": "7ff6cc40-5639-4eac-a062-98d259ae7379",
  "PrimaryOrganizationName": "sample string 13",
  "FullName": "sample string 14",
  "FormalName": "sample string 15",
  "FullOrderedName": "sample string 16",
  "Deleted": true,
  "DeletedByRef": true,
  "Created": "2025-03-06T22:05:01.8423547+00:00",
  "CreatedBy": "95f59a45-99eb-4e0a-9fa9-704fac0b0e3f",
  "Updated": "2025-03-06T22:05:01.8423547+00:00",
  "UpdatedBy": "6b976f8b-21f1-4501-a68a-1d6ae9ae5d2a",
  "IsGlobalAdmin": true,
  "UserEmail": "sample string 19",
  "LastComment": "sample string 20",
  "LastCommentDate": "2025-03-06T22:05:01.8423547+00:00",
  "LastCommentByID": "f6961771-e2f1-417c-b87b-8609205d45bf",
  "LastCommentBy": "sample string 21",
  "CanRead": true,
  "CanUpdate": true,
  "CanDelete": true,
  "CanDelegate": true,
  "SendEvalSurvey": true,
  "HireDate": "2025-03-06T22:05:01.8423547+00:00"
}