Platform API

<back to all web services

GetContactRolesForLicensee

Get contact roles (custom and/or standard) for the specified licensee

Requires Authentication
The following routes are available for this service:
All Verbs/api/contactroles/{LicenseeId}
GetContactRolesForLicensee Parameters:
NameParameterData TypeRequiredDescription
LicenseeIdqueryGuidYesGet contact roles (custom and/or standard) for the specified licensee
ContactTypesqueryList<Guid>NoContact Types
OwnerFilterIdsqueryList<Guid>NoCustom/Standard filter
RecordStatusquerystringNoActive/Archived filter
SearchTextquerystringNoText filter
GetContactRolesForLicenseeResponse Parameters:
NameParameterData TypeRequiredDescription
RolesformList<RoleModel>No
ResponseStatusformResponseStatusNo
RoleModel Parameters:
NameParameterData TypeRequiredDescription
RoleIdformGuidYesRole Id
RoleNameformstringNoRole Name
IsLicenseeRoleformboolNoIs the role a licensee role?
IsManageContactsformboolNoIs manage contacts role?
IsPlatformRoleformboolNoIs the role a Platform role?
IsServiceRoleformboolNoIs the role a services role?
IsCustomerRoleformboolNoIs the role a customer role?
IsFunctionalRoleformboolNoIs the role a functional role?
IsRequestAutoAcceptedformboolNoIs the role an auto-accept role?
SuiteIdformGuidNoSuite that the role belongs to
SuiteNameformstringNoSuite that the role belongs to
RecordStatusformstringNo'A' (Active) or 'I' (Inactive)
ObjectConnectionIdformGuidNoObject Connection Id, which is populated when the roles are returned based on those that are connected to an object.

To override the Content-type in your clients, use the HTTP Accept Header, append the .csv suffix or ?format=csv

HTTP + CSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /api/contactroles/{LicenseeId} HTTP/1.1 
Host: pfapi.pstpf.com.au 
Accept: text/csv
Content-Type: text/csv
Content-Length: length

{"LicenseeId":"00000000-0000-0000-0000-000000000000","ContactTypes":["00000000-0000-0000-0000-000000000000"],"OwnerFilterIds":["00000000-0000-0000-0000-000000000000"],"RecordStatus":"String","SearchText":"String"}
HTTP/1.1 200 OK
Content-Type: text/csv
Content-Length: length

{"Roles":[{"RoleId":"00000000-0000-0000-0000-000000000000","RoleName":"String","IsLicenseeRole":false,"IsManageContacts":false,"IsPlatformRole":false,"IsServiceRole":false,"IsCustomerRole":false,"IsFunctionalRole":false,"IsRequestAutoAccepted":false,"SuiteId":"00000000-0000-0000-0000-000000000000","SuiteName":"String","RecordStatus":"String","ObjectConnectionId":"00000000-0000-0000-0000-000000000000"}],"ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}}}