List Leads
List all Leads
List all Leads
$ curl https://api.intercom.io/contacts \\\n-H 'Authorization:Bearer <Your access token>' \\\n-H 'Accept: application/json'You can fetch a list of all leads. The lead list is sorted by the created_at field and by default is ordered descending, most recently created first. Apart from sorting, the same parameters for the User list apply here.
List Leads by Email
List by Email
$ curl https://api.intercom.io/contacts?email=obrien@truth.org \
-H 'Authorization:Bearer <Your access token>' \
-H 'Accept:application/json'HTTP/1.1 200 OK
{
"type": "contact.list",
"pages": {
"type": "pages",
"next": null,
"page": 1,
"per_page": 50,
"total_pages": 1
},
"contacts": [
{
"type": "contact",
"id": "5811f6bbe6b4704ddfa84ac0",
"user_id": "77177570-cf5d-4f1a-bc75-75202af47d4f",
"anonymous": true,
"email": "obrien@truth.org",
"phone": "00353875551234",
"name": "O'Brien",
"pseudonym": "Lime Camel from Dublin",
"avatar": {
"type": "avatar",
"image_url": null
},
"app_id": "ja43hiec",
"companies": {
"type": "company.list",
"companies": []
},
"location_data": {
"type": "location_data",
"city_name": "Mukilteo",
"continent_code": "NA",
"country_name": "United States",
"latitude": 47.913,
"longitude": -122.3042,
"postal_code": "98275",
"region_name": "Washington",
"timezone": "America/Los_Angeles",
"country_code": "USA"
},
"last_request_at": 1477660267,
"last_seen_ip": "1.2.3.4",
"created_at": 1477572283,
"remote_created_at": null,
"signed_up_at": null,
"updated_at": 1480068674,
"session_count": 0,
"social_profiles": {
"type": "social_profile.list",
"social_profiles": []
},
"unsubscribed_from_emails": false,
"user_agent_data": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.9",
"tags": {
"type": "tag.list",
"tags": []
},
"segments": {
"type": "segment.list",
"segments": []
},
"custom_attributes": {
"paid_subscriber": true,
"monthly_spend": 155.5,
"team_mates": 9
}
}
],
"total_count": 1,
"limited": false
}contacts = intercom.contacts.find_all(email: "joe@example.com")ContactCollection contacts = Contact.listByEmail("joe@example.com");
// get first page...
List<Contact> items = contacts.getPageItems();
// ...or iterate over all pages
while (contacts.hasNext()) {
out.println(contacts.next().getID());
}<?php
$leads= $intercom->leads->getLeads(['email' => 'socrates@phil.com']);
foreach ($leads->contacts as $lead) {
print_r($lead->id);
echo "\n";
}?>You can fetch Leads with a given email by querying the leads resource with an email parameter.
List Leads by Phone
List by Phone
$ curl \\\nhttps://api.intercom.io/contacts?phone=00353875551234 \\\n-H 'Authorization:Bearer <Your access token>' \\\n-H 'Accept:application/json'HTTP/1.1 200 OK\n\n{\n \"type\": \"contact.list\",\n \"pages\": {\n \"type\": \"pages\",\n \"next\": null,\n \"page\": 1,\n \"per_page\": 50,\n \"total_pages\": 1\n },\n \"contacts\": [\n {\n \"type\": \"contact\",\n \"id\": \"5811f6bbe6b4704ddfa84ac0\",\n \"user_id\": \"77177570-cf5d-4f1a-bc75-75202af47d4f\",\n \"anonymous\": true,\n \"email\": \"obrien@truth.org\",\n \"phone\": \"00353875551234\",\n \"name\": \"O'Brien\",\n \"pseudonym\": \"Lime Camel from Dublin\",\n \"avatar\": {\n \"type\": \"avatar\",\n \"image_url\": null\n },\n \"app_id\": \"ja43hiec\",\n \"companies\": {\n \"type\": \"company.list\",\n \"companies\": []\n },\n \"location_data\": {\n \"type\": \"location_data\",\n \"city_name\": \"Mukilteo\",\n \"continent_code\": \"NA\",\n \"country_name\": \"United States\",\n \"latitude\": 47.913,\n \"longitude\": -122.3042,\n \"postal_code\": \"98275\",\n \"region_name\": \"Washington\",\n \"timezone\": \"America/Los_Angeles\",\n \"country_code\": \"USA\"\n },\n \"last_request_at\": 1477660267,\n \"last_seen_ip\": \"1.2.3.4\",\n \"created_at\": 1477572283,\n \"remote_created_at\": null,\n \"signed_up_at\": null,\n \"updated_at\": 1480068674,\n \"session_count\": 0,\n \"social_profiles\": {\n \"type\": \"social_profile.list\",\n \"social_profiles\": []\n },\n \"unsubscribed_from_emails\": false,\n \"user_agent_data\": \"Mozilla/5.0 (Macintosh; Intel Mac OS X 10.9\",\n \"tags\": {\n \"type\": \"tag.list\",\n \"tags\": []\n },\n \"segments\": {\n \"type\": \"segment.list\",\n \"segments\": []\n },\n \"custom_attributes\": {\n \"paid_subscriber\": true,\n \"monthly_spend\": 155.5,\n \"team_mates\": 9\n }\n }\n ],\n \"total_count\": 1,\n \"limited\": false\n}You can fetch Leads with a given phone number by querying the leads resource with a phone parameter.