GET
/
v1
/
contacts
/
find
curl --request GET \
  --url https://app.loops.so/api/v1/contacts/find \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "cll6b3i8901a9jx0oyktl2m4u",
    "email": "[email protected]",
    "firstName": "Bob",
    "lastName": null,
    "source": "API",
    "subscribed": true,
    "userGroup": "",
    "userId": null
  }
]

Request

Query parameters

email
string
required

The contact’s email address. Make sure it is URI-encoded.

Response

This endpoint will return a list of contact objects containing all default properties and any custom properties.

If no contact is found, an empty list will be returned.

Contacts
array
id
string

The contact’s email address.

email
string

The contact’s email address.

firstName
string

The contact’s first name.

lastName
string

The contact’s last name.

source
string

The source the contact was created from.

subscribed
boolean

Whether the contact will receive campaign and loops emails.

userGroup
string

The contact’s user group.

userId
string

A unique user ID (for example, from an external application).