GET api/contacts/{id}/phonecommunications?offset={offset}&limit={limit}&returnTotal={returnTotal}

Get all PhoneCommunications that are related to the supplied Contact id.

Request Information

URI Parameters

Name	Description	Type	Additional information
id	The primary key of the Contact record.	integer	Required
offset	The position in the collection of PhoneCommunications from which to start returning data from.	integer	Default value is 0
limit	The maximum amount of PhoneCommunications that can be returned in any one call. Maximum allowed is 250.	integer	Default value is 50
returnTotal	Whether to include the total amount of PhoneCommunications in the database that match the filter specified.	boolean	Default value is False

Body Parameters

None.

Response Information

Resource Description

PhoneCommunicationDto

Name	Description	Type	Additional information
Id	The primary key of the record in the Hobsons database. Ignored for POST requests sent to the API.	integer	None.
CrmNumber	A reference to the primary key of the Contact record that is associated with this record.	integer	Required Range: inclusive between 1 and 2147483647
Headline	The phone conversation headline.	string	String length: inclusive between 0 and 400
Labels	The labels assigned to this communication	Collection of CommunicationLabelDto	None.
Incoming	Indicates if phone communication is incoming (true) or outgoing (false).	boolean	Required
CommunicationTypeId	A reference to the primary key of the CommunicationType record that is associated with this record.	integer	Required Range: inclusive between 1 and 99999999
CommunicationTypeName	The name of the CommunicationType record that is associated with this record. Ignored for POST requests sent to the API.	string	None.
CommunicationEffectivenessId	A reference to the primary key of the CommunicationEffectiveness record that is associated with this record.	integer	Range: inclusive between 1 and 99999999
CommunicationEffectivenessName	The name of the CommunicationEffectiveness record that is associated with this record. Ignored for POST requests sent to the API.	string	None.
SubChannelId	A reference to the primary key of the SubChannel record that is associated with this record. For POST requests sent to the API, the SubChannel record must belong to the parent Channel named 'External'.	integer	Required Range: inclusive between 1 and 99999999
SubChannelName	The name of the SubChannel record that is associated with this record. Ignored for POST requests sent to the API.	string	None.
ChannelId	A reference to the primary key of the Channel record that is the parent of the SubChannel record. Ignored for POST requests sent to the API.	integer	None.
ChannelName	The name of the Channel record that is the parent of the SubChannel record. Ignored for POST requests sent to the API.	string	None.
Source	The source of the communication.	string	String length: inclusive between 0 and 1000
ReferralSource	The referral source of the communication.	string	String length: inclusive between 0 and 1000
DateCreated	The date that the communication record was created (in the Hobsons database). Ignored for POST requests sent to the API.	date	None.
Task	The details of the Task record created that it's associated with this record. Used ONLY for POST requests sent to the API. Always returned as NULL.	InnerTaskDto	None.

Response Formats

application/json, text/json

Sample:

{
  "Id": 1,
  "CrmNumber": 1,
  "Headline": "sample string 2",
  "Labels": [
    {
      "Id": 1,
      "Name": "sample string 2",
      "Inactive": true
    },
    {
      "Id": 1,
      "Name": "sample string 2",
      "Inactive": true
    }
  ],
  "Incoming": true,
  "CommunicationTypeId": 1,
  "CommunicationTypeName": "sample string 4",
  "CommunicationEffectivenessId": 1,
  "CommunicationEffectivenessName": "sample string 5",
  "SubChannelId": 1,
  "SubChannelName": "sample string 6",
  "ChannelId": 1,
  "ChannelName": "sample string 7",
  "Source": "sample string 8",
  "ReferralSource": "sample string 9",
  "DateCreated": "2025-01-22T22:08:46.7737096+11:00",
  "Task": {
    "TaskTypeId": 1,
    "Description": "sample string 2"
  }
}