Platform Subscription API

GetContacts

Returns a list of contacts with specified roles. There are options to include custom and also to include each contacts connected contacts

**GetContacts** Parameters:
Name	Parameter	Data Type	Required	Description
SuiteDataSourceInstanceId	query	Guid	Yes	Guid representing the external system datasource requesting the contact information. This is required to return any existing object subscription details for each contact.
ContactRoles	query	List<Guid>	Yes	A list of 1 or more roles that a contact must have in order to be returned. (Roles are treated as OR not AND, ie a contact may have one or the other to be returned, but not necessarily both)
ContactTypes	query	List<Guid>	No	A list of contact types that we want returned. If no contact types are specified all 4 major contact types are eligible to be returned. (organisation/person - real/virtual)
IncludeStaff	query	bool	Yes	Set to true if you want to include the any linked staff for each contact.
CustomContentViewId	query	Guid	No	To include custom content then you need to specify the view Id of the content to include.
ModifiedSince	query	DateTime	No	Set the date to return only contacts that have been modified since a particular date.

**GetContactsModel** Parameters:
Name	Parameter	Data Type	Required	Description
Contacts	query	string	Yes	List of Contacts with details.
ContactStaff	query	string	Yes	List of contact-staff details.

**SubscriptionContactModel** Parameters:
Name	Parameter	Data Type	Required	Description
ContactId	query	Guid	No	Guid of the contact object within Eros.
ContactType	query	Guid	Yes	Guid of the Contact Type List Item object within Eros.
MaritalStatus	query	Guid?	No	Guid of the Marital Status List Item object within Eros.
Gender	query	Guid?	No	Guid of the Gender List Item object within Eros.
FirstName	query	string	No	The first given name for the contact. Applies to a person contact type.
MiddleName	query	string	No	The middle name(s) for the contact. Applies to a person contact type.
Surname	query	string	No	The surname for the contact. Applies to a person contact type.
FullName	query	string	No	The full name for the contact.
ShortName	query	string	No	A short name for the contact.
BirthDate	query	DateTime?	No	The birth date for the contact. Applies to a person contact type.
Title	query	string	No	The title for the contact. Applies to a person contact type.
Salutation	query	string	No	A salutation for the contact.
Abn	query	string	No	The A.B.N for the contact.
Acn	query	string	No	The A.C.N for the contact.
Arbn	query	string	No	The A.R.B.N for the contact.
TradingName	query	string	No	A trading name for the contact.
LegalName	query	string	No	A legal name for the contact.
Notes	query	string	No	Any notes/description for the contact.
EmploymentIndustry	query	string	No	Contact Employment Industry.
EmploymentRole	query	string	No	Contact Employment Role.
EmploymentGeographicArea	query	string	No	Contact Employment Geographic Area.
DriversLicence	query	string	No	The Contacts Drivers Licence Number
GstRegistered	query	bool	No	Indicates if the Contact is registered for GST
RecordStatus	query	string	No	The status of the contact in EROS
ContactRoles	query	List<ContactRole>	Yes	A list of roles this contact has.
ContactDetails	query	List<ContactDetailModel>	Yes	A list of the contact details for the contact.
CustomContentXML	query	string	No	Custom Content XML for the contact.
BlobImageURLPrimary	form	string	No
BlobImageURLPrimaryThumbnail	form	string	No
PrimaryMobile	query	string	No	The primary mobile for the contact.
PrimaryEmail	query	string	No	The primary email for the contact.

**ContactRole** Parameters:
Name	Parameter	Data Type	Required	Description
RoleId	query	Guid	Yes	Guid of the Role List Item object within Eros.
AlternateKey	query	string	No	The unique key that represents the role type on the external system.

**ContactDetailModel** Parameters:
Name	Parameter	Data Type	Required
ContactMethodId	form	Guid	No
ContactMethodName	form	string	No
ContactAddress	form	ContactAddressModel	No
ContactPhone	form	PhoneModel	No
CountryId	form	Guid?	No
ContactDetails	form	string	No
Notes	form	string	No
ContactDetailsCode	form	string	No
OrderContactMethod	form	int	No
IsPrimaryContactMethod	form	bool	No
IsAddress	form	bool	No

**ContactAddressModel** Parameters:
Name	Parameter	Data Type	Required
Address	form	AddressModel	No
IsPostal	form	bool	No
IsPrimaryLocation	form	bool	No
IsRegisteredLocation	form	bool	No
SuburbName	form	string	No
StateName	form	string	No
CountryName	form	string	No

**AddressModel** Parameters:
Name	Parameter	Data Type	Required	Description
DistanceAway	query	double	No	The distance between this project and another specified set of gps coordinates.
Latitude	query	Double?	Yes	The latitude of an address - geographic coordinates specifying the north-south position of a point on the Earth's surface.
Longitude	query	Double?	Yes	The longitude of an address - geographic coordinates specifying the east-west position of a point on the Earth's surface.
AddressFormatId	query	Guid	No	Address Format Id Guid - this will be determined by the service.
SuburbId	query	Guid	No	Suburb Id Guid - this will attempt to be determined by the SuburbName, StateShortName and Postcode entered.
SuburbName	query	string	No	The suburb name.
StateShortName	query	string	No	The shortened State Name e.g Vic for Victoria.
PostCode	query	string	No	The suburb postcode.
CountryId	query	Guid	No	Country Id Guid - this will be determined by the CountrName or ISOCountryCode entered.
CountryName	query	string	No	the name of the country the address is within.
ISOCountryCode	query	string	No	A 2 digit ISO Country Code representing the country.
LotNumber	query	string	No	The address Lot number.
SubUnit	query	string	No	The address Sub Unit number.
BuildingNumber	query	string	No	The address building number.
StreetNumber	query	string	No	The address street number.
StreetName	query	string	No	The address street name including street type.
AddressLineOne	query	string	No	A formatted address Line 1.
AddressLineTwo	query	string	No	A formatted address Line 2.
AddressFull	query	string	No	The full address string.
IsPhysical	query	bool?	No	True if the address is a physical location.
Notes	query	string	No	Notes about the address.
AutoMapCoordinates	query	bool?	No	If true, the address is eligible for having its coordinates calculated/updated.
LocationCoordinates	query	LocationCoordinates	No	Location Coordinates for the address.

**LocationCoordinatesModel** Parameters:
Name	Parameter	Data Type	Required	Description
Latitude	query	Double?	Yes	The latitude of an address - geographic coordinates specifying the north-south position of a point on the Earth's surface.
Longitude	query	Double?	Yes	The longitude of an address - geographic coordinates specifying the east-west position of a point on the Earth's surface.
Altitude	query	Double?	No	The altitude of an address - the altitude above sea level.
Accuracy	query	Double?	No	Accuracy of the latitude and longitude.
AltitudeAccuracy	query	Double?	No	Accurancy of the Altitude.
Heading	query	Double?	No	Direction you are heading.
Speed	query	Double?	No	Speed you are going.
VerticalSpeed	query	Double?	No	Speed your altitude is ascending/descending at.

**PhoneModel** Parameters:
Name	Parameter	Data Type	Required
CountryCode	form	string	No
AreaCode	form	string	No
LocalNumber	form	string	No

**ContactsStaff** Parameters:
Name	Parameter	Data Type	Required	Description
ContactId	form	Guid	No
ContactStaffId	form	Guid	No

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

HTTP + XML

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

POST /xml/reply/GetContacts HTTP/1.1 
Host: production-eros-platform-apisubscription.azurewebsites.net 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<GetContacts xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Eros.Subtle.Canvara.WebAPIModel.ServiceModelSubscription">
  <ContactRoles xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:guid>00000000-0000-0000-0000-000000000000</d2p1:guid>
  </ContactRoles>
  <ContactTypes xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:guid>00000000-0000-0000-0000-000000000000</d2p1:guid>
  </ContactTypes>
  <CustomContentViewId>00000000-0000-0000-0000-000000000000</CustomContentViewId>
  <IncludeStaff>false</IncludeStaff>
  <ModifiedSince>0001-01-01T00:00:00</ModifiedSince>
  <SuiteDataSourceInstanceId>00000000-0000-0000-0000-000000000000</SuiteDataSourceInstanceId>
</GetContacts>

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<GetContactsModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Eros.Saguna.Common.WebAPI.ServiceModel">
  <ContactStaff xmlns:d2p1="http://schemas.datacontract.org/2004/07/Eros.Causal.Common.Entity" i:nil="true" />
  <Contacts i:nil="true" />
</GetContactsModel>