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 Deprecated
Contact-Organization relationships are now managed through Account-Contact end points
Performance Tip for Pagination and Contacts
Accounts 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.
{
"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"
}
}
}