Platform API

<back to all web services

GetSlimContacts

Get contacts connected to the current contact or licensee (if managing licensee contacts) by criteria, returning minimal number of columns

Requires Authentication
The following routes are available for this service:
All Verbs/api/slimcontacts
GetSlimContacts Parameters:
NameParameterData TypeRequiredDescription
SearchTextquerystringNoSpecific search text to search for, e.g. Contact Name, Employment Details etc.
ContactTypesqueryList<Guid>YesContact Types to search for, i.e. People and/or Organisations
StatusesqueryList<Guid>YesContact statuses to search for, i.e. Real and/or Virtual
IncludeRemovedqueryboolNoInclude contacts previously connected to the contact but now removed.
IsPagedModequeryboolNoReturn all contacts matching criteria, or paged results?
PagedModel Parameters:
NameParameterData TypeRequiredDescription
PageNumberformintNoPage Number to retrieve
PageSizeformintNoNumber of records to retrieve
SortIndexformintNoIndex of field to sort results by
SortOrderformintNoSort Order - Ascending or Descending
SortOrder Enum:
Ascending
Descending
GetSlimContactsResponse Parameters:
NameParameterData TypeRequiredDescription
ContactsformList<ContactSummaryModel>No
TotalContactsformintNo
ResponseStatusformResponseStatusNo
ContactSummaryModel Parameters:
NameParameterData TypeRequiredDescription
ContactIdformGuidNoContact linked to the profile
ContactFullNameformstringNoFull name of the contact linked to the profile
EmailAddressformstringNoEmail Address of the contact linked to the profile
MobileNumberformstringNoMobile Number of the contact linked to the profile
PhoneNumberformstringNoPrimary Phone Number of the contact linked to the profile
ContactTypeIdformstringNoType of contact (person, organisation etc.) linked to the profile
ProfilePhotoUrlformstringNoProfile photo of contact linked to the profile
ProfilePhotoThumbnailUrlformstringNoThumbnail photo of contact linked to the profile
DescriptionformstringNoProfile description
EmploymentIndustryformstringNoEmployment Industry
EmploymentRoleformstringNoEmployment Role
EmploymentGeographicAreaformstringNoAreas of Work
TimezoneNamequerystringNoTimezone Name
PrimaryAddressquerystringNoThe primary address of the contact
IsRemovedContactformboolNoHave all connections to the contact been removed?

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/slimcontacts HTTP/1.1 
Host: pfapi.pstpf.com.au 
Accept: text/csv
Content-Type: text/csv
Content-Length: length

{"SearchText":"String","ContactTypes":["00000000-0000-0000-0000-000000000000"],"Statuses":["00000000-0000-0000-0000-000000000000"],"IncludeRemoved":false,"IsPagedMode":false,"PageNumber":0,"PageSize":0,"SortIndex":0,"SortOrder":"Ascending"}
HTTP/1.1 200 OK
Content-Type: text/csv
Content-Length: length

{"Contacts":[{"ContactId":"00000000-0000-0000-0000-000000000000","ContactFullName":"String","EmailAddress":"String","MobileNumber":"String","PhoneNumber":"String","ContactTypeId":"00000000-0000-0000-0000-000000000000","ProfilePhotoUrl":"String","ProfilePhotoThumbnailUrl":"String","Description":"String","EmploymentIndustry":"String","EmploymentRole":"String","EmploymentGeographicArea":"String","TimezoneName":"String","PrimaryAddress":"String","IsRemovedContact":false}],"TotalContacts":0,"ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}}}