Skip to main content
GET
/
contacts
Get Many Contacts
curl --request GET \
  --url https://api.lemlist.com/api/contacts \
  --header 'Authorization: Basic <encoded-value>'
[
  {
    "_id": "ctc_Rofmb6uNGyaPNZ2ni",
    "teamId": "tea_b4rMsi2trB42WyuWP",
    "fullName": "Bastien Velitchkine",
    "email": "support@lemlist.com",
    "fields": {
      "firstName": "Bastien",
      "jobTitle": "Growth Engineer",
      "lastName": "Velitchkine",
      "industry": "Technology",
      "isActiveInCampaigns": false,
      "lastCampaign": "NEW TO DELETE",
      "lastLeadMarkedAsInterestedDate": "2025-10-28T02:12:31.971Z",
      "leadStatus": "Marked as not Interested by api"
    },
    "campaigns": [
      {
        "campaignId": "cam_9NsHPnykWESTncCW8",
        "campaignState": "running",
        "leadState": "review",
        "leadId": "lea_mizMsAEkRrJuhouYe"
      }
    ],
    "ownerId": "usr_gmHgNGRcGPSTJrDbT",
    "createdAt": "2025-10-28T00:40:37.917Z",
    "createdBy": "usr_gmHgNGRcGPSTJrDbT",
    "unsubscribed": false
  },
  {
    "_id": "ctc_8aECJTHfPfbMy6mSG",
    "teamId": "tea_b4rMsi2trB42WyuWP",
    "fullName": "Chafik",
    "email": "chafik@lemlist.co",
    "fields": {
      "firstName": "Chafik",
      "isActiveInCampaigns": false
    },
    "campaigns": [
      {
        "campaignId": "cam_aMkkjon7Ggb86v4qk",
        "campaignState": "running",
        "leadState": "done",
        "leadId": "lea_etnTnRnnGPzayGdMm"
      },
      {
        "campaignId": "cam_HjAXkn4woJgvRgj7Q",
        "campaignState": "running",
        "leadState": "done",
        "leadId": "lea_5KQh7BKpiCicxTZsG"
      },
      {
        "campaignId": "cam_FYRAZMW5utAA7LXCN",
        "campaignState": "running",
        "leadState": "done",
        "leadId": "lea_CG8KkGEKYMpZFREgp"
      },
      {
        "campaignId": "cam_JnZqKnuSvoD4jsQuo",
        "campaignState": "running",
        "leadState": "review",
        "leadId": "lea_K5Kcyg2vSN4PLZunL"
      }
    ],
    "ownerId": "usr_4YGm9ez7gMd2okyRp",
    "createdAt": "2024-10-01T09:00:13.831Z",
    "createdBy": "usr_4YGm9ez7gMd2okyRp",
    "unsubscribed": true
  }
]
This endpoint uses the Contact object.

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Query Parameters

idsOrEmails
string
required

A comma separated string of either valid contact IDs (MongoDB ObjectId) or valid email addresses

Response

Success

_id
string

Unique contact identifier

teamId
string

Team identifier the contact belongs to

fullName
string

Contact's calculated full name

email
string<email>

Contact's primary email address

fields
object

Custom fields associated with the contact

campaigns
object[]

List of campaigns the contact is associated with

ownerId
string

ID of the user who owns this contact

createdAt
string<date-time>

Contact creation timestamp

createdBy
string

ID of the user who created the contact

unsubscribed
boolean

Whether the contact is globally unsubscribed. When true, no outreach will be sent to this contact.