get https://{youraccountname}.api-us1.com/api/3/contacts
Use this API endpoint to list all contacts, search contacts, or filter contacts by many criteria. For example, search for specific contacts by email, list, account.
Organization-Related Nodes Have Been DeprecatedContact-Organization relationships are now managed through Account-Contact end points
Performance Tip for PaginationAccounts with many Contacts may encounter slower responses when using the
offsetparameter to paginate with this endpoint. For best performance sort usingorders[id]=ASCand use theid_greaterparameter to paginate. This is especially important when calling this endpoint frequently, such as when retrieving many or all Contacts from an account.Note that when using the
segmentidparameter, best performance will be achieved by: paginating using theoffsetparameter and not using anyordersparameter.
{
"contacts":[
{
"cdate":"2017-01-25T23:58:14-06:00",
"email":"[email protected]",
"phone":"3120000000",
"firstName":"John",
"lastName":"Doe",
"orgid":"0",
"segmentio_id":"",
"bounced_hard":"0",
"bounced_soft":"0",
"bounced_date":"0000-00-00",
"ip":"0",
"ua":"",
"hash":"31e076c964f4262817f9ba302c96e1c6",
"socialdata_lastcheck":"0000-00-00 00:00:00",
"email_local":"",
"email_domain":"",
"sentcnt":"0",
"rating_tstamp":"0000-00-00",
"gravatar":"3",
"deleted":"0",
"adate":"2017-02-22 15:26:24",
"udate":"2017-01-25T23:58:14-06:00",
"edate":"2017-01-27 14:44:13",
"scoreValues":[
],
"links":{
"bounceLogs":"https://:account.api-us1.com/api/:version/contacts/68/bounceLogs",
"contactAutomations":"https://:account.api-us1.com/api/:version/contacts/68/contactAutomations",
"contactData":"https://:account.api-us1.com/api/:version/contacts/68/contactData",
"contactGoals":"https://:account.api-us1.com/api/:version/contacts/68/contactGoals",
"contactLists":"https://:account.api-us1.com/api/:version/contacts/68/contactLists",
"contactLogs":"https://:account.api-us1.com/api/:version/contacts/68/contactLogs",
"contactTags":"https://:account.api-us1.com/api/:version/contacts/68/contactTags",
"contactDeals":"https://:account.api-us1.com/api/:version/contacts/68/contactDeals",
"deals":"https://:account.api-us1.com/api/:version/contacts/68/deals",
"fieldValues":"https://:account.api-us1.com/api/:version/contacts/68/fieldValues",
"geoIps":"https://:account.api-us1.com/api/:version/contacts/68/geoIps",
"notes":"https://:account.api-us1.com/api/:version/contacts/68/notes",
"organization":"https://:account.api-us1.com/api/:version/contacts/68/organization",
"plusAppend":"https://:account.api-us1.com/api/:version/contacts/68/plusAppend",
"trackingLogs":"https://:account.api-us1.com/api/:version/contacts/68/trackingLogs",
"scoreValues":"https://:account.api-us1.com/api/:version/contacts/68/scoreValues"
},
"id":"68",
"organization":null
},
{
"cdate":"2017-02-09T12:14:58-06:00",
"email":"[email protected]",
"phone":"",
"firstName":"Aaron",
"lastName":"Allen",
"orgid":"14",
"segmentio_id":"",
"bounced_hard":"0",
"bounced_soft":"0",
"bounced_date":"0000-00-00",
"ip":"0",
"ua":"",
"hash":"31b92c033c3e55de6d9eb9c44ee1bfa5",
"socialdata_lastcheck":"0000-00-00 00:00:00",
"email_local":"",
"email_domain":"",
"sentcnt":"0",
"rating_tstamp":"0000-00-00",
"gravatar":"1",
"deleted":"0",
"adate":"2017-03-16 13:18:12",
"udate":"2017-02-09T12:14:58-06:00",
"edate":"0000-00-00 00:00:00",
"scoreValues":[
],
"accountContacts": [
"1"
],
"links":{
"bounceLogs":"https://:account.api-us1.com/api/:version/contacts/73/bounceLogs",
"contactAutomations":"https://:account.api-us1.com/api/:version/contacts/73/contactAutomations",
"contactData":"https://:account.api-us1.com/api/:version/contacts/73/contactData",
"contactGoals":"https://:account.api-us1.com/api/:version/contacts/73/contactGoals",
"contactLists":"https://:account.api-us1.com/api/:version/contacts/73/contactLists",
"contactLogs":"https://:account.api-us1.com/api/:version/contacts/73/contactLogs",
"contactTags":"https://:account.api-us1.com/api/:version/contacts/73/contactTags",
"contactDeals":"https://:account.api-us1.com/api/:version/contacts/73/contactDeals",
"deals":"https://:account.api-us1.com/api/:version/contacts/73/deals",
"fieldValues":"https://:account.api-us1.com/api/:version/contacts/73/fieldValues",
"geoIps":"https://:account.api-us1.com/api/:version/contacts/73/geoIps",
"notes":"https://:account.api-us1.com/api/:version/contacts/73/notes",
"organization":"https://:account.api-us1.com/api/:version/contacts/73/organization",
"plusAppend":"https://:account.api-us1.com/api/:version/contacts/73/plusAppend",
"trackingLogs":"https://:account.api-us1.com/api/:version/contacts/73/trackingLogs",
"scoreValues":"https://:account.api-us1.com/api/:version/contacts/73/scoreValues"
},
"id":"73",
"organization":"14"
}
],
"meta":{
"total":"2",
"page_input":{
"segmentid":null,
"formid":0,
"listid":0,
"tagid":0,
"limit":20,
"offset":0,
"search":null,
"sort":null,
"seriesid":0,
"waitid":0,
"status":-1,
"forceQuery":0,
"cacheid":"895202850f4ca4144513c0962812f951"
}
}
}