GetContacts

Overview

Lists contact or contacts based on information sent via this form post.
Important Note about pagination - limit is required as a return size.

URL

POST/api/2/GetContacts.aspx

Parameters

FieldMax LengthRequiredNotes
response_typefalseDefault results will be returned as XML.
Set value to json to return in JSON format.
pagingsizefalseStrongly Recommended for API use.
Limit the amount to return per call.
All API call without calls to the paginate will be delayed.
pagingoffsetfalseNumber of records to offset the start pagination with this call.
All API call without calls to the paginate will be delayed.
accountidfalseMust be numeric.
Specify multiple + API
Separate by the default state
for multiple values with a comma.

Must be numeric. 0 (all) Best reserved specifically to contact record lookups by contactid.
teammemberidfalse
apikeytrueMust be numeric.
Specify multiple + API
Separate by the default state
for multiple values with a comma.

Specify contact id using the keyword id "Contact".
contactidfalseIf this contactid is left blank, all contacts will be returned per the condition.
email or otheremailfalseSpecify an email address. Wildcards(*) allowed at the start or finish if email contains pattern.
phonefalseSpecify a phone number. Contact search scans all contact fields. Multiple wildcards(*) allowed at the start or finish if number contains patterns.
Other text fields (firstname, lastname, otherfirstname, otherlastname, company, address, city, state, postalcode, custom1, custom2, etc...)falseMultiple matches will be returned where test data matches.
categoryidfalseSpecify a Category ID. Only contacts with matching values will be returned.
See note "name" matching option to use name instead.
Also use "name" matching option to use "name!" for NOT category.
category2idfalseSpecify a Category 2 ID. Only contacts with matching values will be returned. Category 2 is the last part be named grouping.
See note "name" matching option to use name instead.
Also use "name" matching option to use "name!" for NOT category.
flagidfalseSpecify a Flag ID, Also use name:flagname matching
sourceidfalseSpecify a Source ID.
Only contacts with Source ID will be returned
(see notes)
othersystemidfalseSpecify contact id using the keyword id "Contact"
importbatchidfalseSpecify Import Batch ID number to pull all contacts with
ImportBatches. Optional parameter is
ShowBatchName=1, otherwise
shows the current batch Group will be used.
clienttouchfalseSpecify 1 to select only contacts that are in the Team Members ClientTouch Workgroup
getcategoriesfalseSpecify 1 to display detail. Use this option only when needed, it will slow down your results
getflagsfalseSpecify 1 to display detail. Use this option only when needed, it will slow down your results
getsourcefalseSpecify 1 to display detail. Use this option only when needed, it will slow down your results
getteamfalseSpecify 1 to display detail. Use this option only when needed, it will slow down your results
adddateafterfalseWill return entries added after this date/time/package, or anything added to your ACMnCRM after this date.

Time Zone for Add Date is US Central Time.

Enter a date in
US Date / Time Format
example: 04/20/11 22:00
aftereditdatefalseOnly Contacts edited after this date/time will be included.

4/24/2013 excludes
records changed before
4/24/2013. All others will
be included.

Time Zone for Add Date is
US Central Time.