Qodex.ai

List of contacts by IDs

GET {{baseUrl}}/contacts/:contactId?relationships=false

Returns one or more contacts by given contact IDs

Query Parameters

Form ParametertypeMandatoryDescription
offsetnumberRequiredExample = 0
limitnumberRequiredExample = 500
relationshipsOptionalTrue/False - Include contact relationships

Response Body

Returns a list of objects that will contain a combination of the below keys

KeyDatatypeMandatoryConstraints
contactTypeStringYesMust be one of 'People'/'Company'/Other Entity’/’Joint Member’
firstNameStringYesOnly mandatory if the contactType is 'People'
middleNameStringNoOnly allowed if contactType is 'People'
lastNameStringYesOnly mandatory if the contactType is 'People'
nameStringYesOnly mandatory if the contactType is 'Company'/'Other Entity'
addressIdNumberYesWill be ignored if the contactType is 'Joint Member'. Must be a valid existing addressId
representativeIdsList of NumbersYesOnly mandatory if the contactType is 'Joint Member'. Can only contain contactIds of non Joint Members
titleStringNoOnly allowed if contactType is 'People'
sexStringNoOnly allowed if contactType is 'People'. Must be one of 'Male'/'Female'
emailStringNo
mobileStringNo
phone1StringNo
phone2StringNo
taxNumberStringNo
birthdayStringNoOnly allowed if contactType is 'People'. ISO 8601 date https://en.wikipedia.org/wiki/ISO_8601
birthPlaceStringNoOnly allowed if contactType is 'People'
birthStateStringNoOnly allowed if contactType is 'People'. Must be one of 'ACT'/'NSW'/'VIC'/'QLD'/'SA'/'WA'/'TAS'/'NT'/'Foreign'
birthCountryStringNoOnly allowed if contactType is 'People'. ISO 3166 country code/name https://en.wikipedia.org/wiki/ISO_3166
skypeStringNoOnly allowed if contactType is 'People'
companyNumberStringNoOnly allowed if the contactType is one of 'Company'/'Other Entity'
businessNumberStringNoOnly allowed if the contactType is one of 'Company'/'Other Entity'
placeOfIncorportaionStringNoOnly allowed if the contactType is one of 'Company'/'Other Entity'. ISO 3166 country code/name https://en.wikipedia.org/wiki/ISO_3166
incorporationDateStringNoOnly allowed if the contactType is one of 'Company'/'Other Entity'. ISO 8601 date https://en.wikipedia.org/wiki/ISO_8601
typeStringNoOnly allowed if the contactType is 'Other Entity'. Must be one of ‘OTHER', 'SMSF', 'PARTNERSHIP' and 'TRUST' Wll only appear for Other Entity contacts
nationalityStringNoISO 3166 country code/name https://en.wikipedia.org/wiki/ISO_3166 e.g AU
relationshipsArrayNo

Relationships array

KeyDatatypeComment
endDateDate
parentIdString
parentTypeString
startDateDate
typeString

Request Params

KeyDatatypeRequiredDescription
relationshipsboolean[optional] response will not include relationships if parameter not used

HEADERS

KeyDatatypeRequiredDescription
Authorizationstring

RESPONSES

status: OK

[{"id":54,"name":"Fancy Southern Africa Cat Council","contactType":"Company","email":"","mobile":"","phone1":null,"phone2":null,"taxNumber":null,"businessNumber":null,"companyNumber":"111111114","addressId":15,"representativeIds":null,"incorporationDate":null,"placeOfIncorporation":"AUSTRALIA","firstName":null,"middleName":null,"lastName":null,"title":null,"sex":null,"birthday":null,"birthPlace":null,"birthState":null,"birthCountry":null,"skype":null,"nationality":null},{"id":555742,"name":"Anne Smith","contactType":"People","email":"anne@bgglcorp.com.au","mobile":"","phone1":null,"phone2":null,"taxNumber":null,"businessNumber":null,"companyNumber":null,"addressId":172509,"representativeIds":null,"incorporationDate":null,"placeOfIncorporation":null,"firstName":"Anne","middleName":null,"lastName":"Smith","title":null,"sex":null,"birthday":"1958-07-02","birthPlace":"Phillip Island","birthState":"VIC","birthCountry":"AUSTRALIA","skype":null,"nationality":null}]