Skip to main content
GET
/
v1
/
contacts
/
find
Find contact
curl --request GET \
  --url https://app.loops.so/api/v1/contacts/find \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "cll6b3i8901a9jx0oyktl2m4u",
    "email": "test@example.com",
    "firstName": "Bob",
    "lastName": null,
    "source": "API",
    "subscribed": true,
    "userGroup": "",
    "userId": null,
    "mailingLists": {
      "cm06f5v0e45nf0ml5754o9cix": true
    },
    "optInStatus": "accepted"
  }
]

​
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": "cll6b3i8901a9jx0oyktl2m4u",
    "email": "test@example.com",
    "firstName": "Bob",
    "lastName": null,
    "source": "API",
    "subscribed": true,
    "userGroup": "",
    "userId": null,
    "mailingLists": {
      "cm06f5v0e45nf0ml5754o9cix": true
    },
    "optInStatus": "accepted"
  }
]
Last modified on May 20, 2026