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"
  },
  {
    "_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"
  }
]
This endpoint uses the Contact object.
This endpoint retrieves a list of all contacts.

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