| All Verbs | /api/contactrole/{ContactRoleId} |
|---|
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| ContactRoleId | query | Guid | Yes | The Contact Role Guid. Records retrieved will belong to this contact. |
| SearchText | query | string | No | Text filter |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| PageNumber | form | int | No | Page Number to retrieve |
| PageSize | form | int | No | Number of records to retrieve |
| SortIndex | form | int | No | Index of field to sort results by |
| SortOrder | form | int | No | Sort Order - Ascending or Descending |
| Ascending | |
| Descending |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| ContactRole | form | ViewRoleModel | No | |
| ResponseStatus | form | ResponseStatus | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| RoleId | form | Guid | Yes | Role Id |
| RoleName | form | string | No | Role Name |
| RoleConnectionDefinitionId | form | Guid | No | Role Connection Definition Id |
| ContactTypes | form | List | No | Contact Types the Role applies to |
| RequireContactsToAccept | form | bool | No | Does the role require contacts to accept it? |
| IsPlatformRole | form | bool | No | |
| CanAddContacts | form | bool | No | |
| CanShareRole | form | bool | No | |
| CanEditRole | form | bool | No | |
| CanEditContactTypes | form | bool | No | |
| Contacts | form | List<UserProfileSummaryModel> | No | |
| ShareDetails | form | IList<ObjectShareModel> | No | |
| ListItemFilters | form | List<ListItemFilterModel> | No | |
| ContactIdOwner | form | Guid | No | |
| TotalItemCount | form | int | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| UserProfileId | form | Guid | No | User Profile Id |
| UserId | form | Guid | No | User linked to the profile |
| ContactId | form | Guid | No | Contact linked to the profile |
| UserName | form | string | No | User linked to the profile |
| ProfileName | form | string | No | User Profile Name |
| ContactFullName | form | string | No | Full name of the contact linked to the profile |
| EmailAddress | form | string | No | Email Address of the contact linked to the profile |
| EmailSignature | form | string | No | Email signature of the contact linked to the profile |
| MobileNumber | form | string | No | Mobile number of the contact linked to the profile |
| PhoneNumber | form | string | No | Phone number of the contact linked to the profile |
| ContactTypeId | form | string | No | Type of contact (person, organisation etc.) linked to the profile |
| ContactTypeName | form | string | No | Type of contact (person, organisation etc.) linked to the profile |
| FirstName | form | string | No | First name of the contact linked to the profile |
| Surname | form | string | No | Surname of the contact linked to the profile |
| Title | form | string | No | Title of contact linked to the profile |
| LegalName | form | string | No | Legal name of contact linked to the profile |
| TradingName | form | string | No | Trading name of contact linked to the profile |
| Abn | query | string | No | Australian Business Number |
| Acn | query | string | No | Australian Company Number |
| Arbn | query | string | No | Australian Registered Body Number |
| GstRegistered | query | bool | No | Indicates if the Contact is registered for GST. |
| ESL | query | bool | No | True if english is a secondary language for the contact. |
| Language | query | string | No | Language that is the primary language for the contact. |
| InterpreterRequired | query | bool | No | True if an interpreter is required. |
| LicenseeNotes | query | string | No | Licensee specific notes about the contact. |
| ProfilePhotoUrl | form | string | No | Profile photo of contact linked to the profile |
| ProfilePhotoThumbnailUrl | form | string | No | Thumbnail photo of contact linked to the profile |
| ProfileImageId | form | Guid | No | Profile photo id of contact linked to the profile |
| Description | form | string | No | Profile description |
| EmploymentIndustry | form | string | No | Employment Industry |
| EmploymentRole | form | string | No | Employment Role |
| EmploymentGeographicArea | form | string | No | Areas of Work |
| Timezone | query | Guid | No | The contacts timezone. |
| TimezoneName | query | string | No | Timezone Name |
| PrimaryAddress | query | string | No | The primary address of the contact |
| IsActiveContact | form | bool | No | Is this an active contact? Or an inactive contact (deleted account)? |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| ObjectShareId | form | Guid | No | |
| ObjectId | form | Guid | No | |
| ObjectName | form | string | No | |
| Name | form | string | No | |
| Description | form | string | No | |
| Reference | form | string | No | |
| ContactId | form | Guid | No | |
| ContactName | form | string | No | |
| ContactType | form | string | No | |
| ContactImageUrlPrimary | form | string | No | |
| ContactImageUrlPrimaryThmbnail | form | string | No | |
| ShareStatusId | form | Guid | No | |
| ShareStatusName | form | string | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| ListItemFilterId | form | Guid | No | |
| FilterName | form | string | No | |
| ListId | form | Guid | No | |
| ListItemId | form | Guid | No | |
| ListItemIsInFilter | form | bool | No |
To override the Content-type in your clients, use the HTTP Accept Header, append the .csv suffix or ?format=csv
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /api/contactrole/{ContactRoleId} HTTP/1.1
Host: pfapi.pstpf.com.au
Accept: text/csv
Content-Type: text/csv
Content-Length: length
{"ContactRoleId":"00000000-0000-0000-0000-000000000000","SearchText":"String","PageNumber":0,"PageSize":0,"SortIndex":0,"SortOrder":"Ascending"}
HTTP/1.1 200 OK
Content-Type: text/csv
Content-Length: length
{"ContactRole":{"RoleId":"00000000-0000-0000-0000-000000000000","RoleName":"String","RoleConnectionDefinitionId":"00000000-0000-0000-0000-000000000000","ContactTypes":["00000000-0000-0000-0000-000000000000"],"RequireContactsToAccept":false,"IsPlatformRole":false,"CanAddContacts":false,"CanShareRole":false,"CanEditRole":false,"CanEditContactTypes":false,"Contacts":[{"UserProfileId":"00000000-0000-0000-0000-000000000000","UserId":"00000000-0000-0000-0000-000000000000","ContactId":"00000000-0000-0000-0000-000000000000","UserName":"String","ProfileName":"String","ContactFullName":"String","EmailAddress":"String","EmailSignature":"String","MobileNumber":"String","PhoneNumber":"String","ContactTypeId":"00000000-0000-0000-0000-000000000000","ContactTypeName":"String","FirstName":"String","Surname":"String","Title":"String","LegalName":"String","TradingName":"String","Abn":"String","Acn":"String","Arbn":"String","GstRegistered":false,"ESL":false,"Language":"String","InterpreterRequired":false,"LicenseeNotes":"String","ProfilePhotoUrl":"String","ProfilePhotoThumbnailUrl":"String","ProfileImageId":"00000000-0000-0000-0000-000000000000","Description":"String","EmploymentIndustry":"String","EmploymentRole":"String","EmploymentGeographicArea":"String","Timezone":"00000000-0000-0000-0000-000000000000","TimezoneName":"String","PrimaryAddress":"String","IsActiveContact":false}],"ShareDetails":null,"ListItemFilters":[{"ListItemFilterId":"00000000-0000-0000-0000-000000000000","FilterName":"String","ListId":"00000000-0000-0000-0000-000000000000","ListItemId":"00000000-0000-0000-0000-000000000000","ListItemIsInFilter":false}],"ContactIdOwner":"00000000-0000-0000-0000-000000000000","TotalItemCount":0,"PageNumber":0,"PageSize":0,"SortIndex":0,"SortOrder":"Ascending"},"ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}}}