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

Search by email or user ID. Only one parameter is allowed.

email
string

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

userId
string

The contact’s unique user ID.

​
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

The contact’s unique user ID.

Was this page helpful?

Update contactDelete contact