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,
    "mailingLists": {
      "cm06f5v0e45nf0ml5754o9cix": true
    }
  }
]

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": "[email protected]",
    "firstName": "Bob",
    "lastName": null,
    "source": "API",
    "subscribed": true,
    "userGroup": "",
    "userId": null,
    "mailingLists": {
      "cm06f5v0e45nf0ml5754o9cix": true
    }
  }
]