POST 17.0/app/contacts/list/ids

Description

Gets a list of Contacts based on the passed contact Ids

URI Parameters

None.

Collection of integer

application/json, text/json
Sample: 
[
  1,
  2
]

application/xml, text/xml
Sample: 
<ArrayOfInt xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <int>1</int>
  <int>2</int>
</ArrayOfInt>

application/x-www-form-urlencoded
Sample:

Sample not available.

Collection of ContactListItem
Name Description Type Additional information
ID

integer

None.
FirstNames

string

None.
LastName

string

None.
CompanyName

string

None.
Type

IDDescriptionPair

None.
Status

IDDescriptionPair

None.
HomeTelephone

string

None.
WorkTelephone

string

None.
MobileTelephone

string

None.
AltTelephone

string

None.
TelephoneNumbers

string

None.
Email

string

None.
AddedDate

date

None.
LastContactedDate

date

None.
MarketingPreferences

MarketingPreferences

None.

application/json, text/json
Sample: 
[
  {
    "id": 1,
    "firstNames": "sample string 2",
    "lastName": "sample string 3",
    "companyName": "sample string 4",
    "type": {
      "id": 1,
      "description": "sample string 2"
    },
    "status": {
      "id": 1,
      "description": "sample string 2"
    },
    "homeTelephone": "sample string 5",
    "workTelephone": "sample string 6",
    "mobileTelephone": "sample string 7",
    "altTelephone": "sample string 8",
    "telephoneNumbers": "sample string 9",
    "email": "sample string 10",
    "addedDate": "2025-09-13T08:07",
    "lastContactedDate": "2025-09-13T08:07",
    "marketingPreferences": {
      "post": true,
      "email": true,
      "smsText": true,
      "telephone": true,
      "passDetailsToThirdParties": true,
      "passDetailsToIFA": true,
      "passDetailsToConveyancer": true
    }
  },
  {
    "id": 1,
    "firstNames": "sample string 2",
    "lastName": "sample string 3",
    "companyName": "sample string 4",
    "type": {
      "id": 1,
      "description": "sample string 2"
    },
    "status": {
      "id": 1,
      "description": "sample string 2"
    },
    "homeTelephone": "sample string 5",
    "workTelephone": "sample string 6",
    "mobileTelephone": "sample string 7",
    "altTelephone": "sample string 8",
    "telephoneNumbers": "sample string 9",
    "email": "sample string 10",
    "addedDate": "2025-09-13T08:07",
    "lastContactedDate": "2025-09-13T08:07",
    "marketingPreferences": {
      "post": true,
      "email": true,
      "smsText": true,
      "telephone": true,
      "passDetailsToThirdParties": true,
      "passDetailsToIFA": true,
      "passDetailsToConveyancer": true
    }
  }
]

application/xml, text/xml
Sample: 
<ArrayOfContactListItem xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <ContactListItem>
    <ID>1</ID>
    <FirstNames>sample string 2</FirstNames>
    <LastName>sample string 3</LastName>
    <CompanyName>sample string 4</CompanyName>
    <Type>
      <ID>1</ID>
      <Description>sample string 2</Description>
    </Type>
    <Status>
      <ID>1</ID>
      <Description>sample string 2</Description>
    </Status>
    <HomeTelephone>sample string 5</HomeTelephone>
    <WorkTelephone>sample string 6</WorkTelephone>
    <MobileTelephone>sample string 7</MobileTelephone>
    <AltTelephone>sample string 8</AltTelephone>
    <TelephoneNumbers>sample string 9</TelephoneNumbers>
    <Email>sample string 10</Email>
    <AddedDate>2025-09-13T08:07:45.2636372+01:00</AddedDate>
    <LastContactedDate>2025-09-13T08:07:45.2636372+01:00</LastContactedDate>
    <MarketingPreferences>
      <Post>true</Post>
      <Email>true</Email>
      <SmsText>true</SmsText>
      <Telephone>true</Telephone>
      <PassDetailsToThirdParties>true</PassDetailsToThirdParties>
      <PassDetailsToIFA>true</PassDetailsToIFA>
      <PassDetailsToConveyancer>true</PassDetailsToConveyancer>
    </MarketingPreferences>
  </ContactListItem>
  <ContactListItem>
    <ID>1</ID>
    <FirstNames>sample string 2</FirstNames>
    <LastName>sample string 3</LastName>
    <CompanyName>sample string 4</CompanyName>
    <Type>
      <ID>1</ID>
      <Description>sample string 2</Description>
    </Type>
    <Status>
      <ID>1</ID>
      <Description>sample string 2</Description>
    </Status>
    <HomeTelephone>sample string 5</HomeTelephone>
    <WorkTelephone>sample string 6</WorkTelephone>
    <MobileTelephone>sample string 7</MobileTelephone>
    <AltTelephone>sample string 8</AltTelephone>
    <TelephoneNumbers>sample string 9</TelephoneNumbers>
    <Email>sample string 10</Email>
    <AddedDate>2025-09-13T08:07:45.2636372+01:00</AddedDate>
    <LastContactedDate>2025-09-13T08:07:45.2636372+01:00</LastContactedDate>
    <MarketingPreferences>
      <Post>true</Post>
      <Email>true</Email>
      <SmsText>true</SmsText>
      <Telephone>true</Telephone>
      <PassDetailsToThirdParties>true</PassDetailsToThirdParties>
      <PassDetailsToIFA>true</PassDetailsToIFA>
      <PassDetailsToConveyancer>true</PassDetailsToConveyancer>
    </MarketingPreferences>
  </ContactListItem>
</ArrayOfContactListItem>