Buscar contactos

Encuentra los contactos del negocio autenticado que coinciden con un email, un teléfono y/o tu external_id. Úsalo para comprobar si un contacto ya existe antes de crearlo, o para encontrar duplicados.

GET/contacts

Autenticación

Este endpoint se autentica con tu API key enviada en la cabecera X-API-Key (formato ek_live_...). Puedes gestionar tus API keys desde la sección Dev Tools del panel.

Parámetros de consulta

Parámetro	Tipo	Obligatorio	Descripción
`email`	String	Opcional	Correo electrónico, sin distinguir mayúsculas.
`phone`	String	Opcional	Teléfono con código de país, solo dígitos. Coincide con o sin el 9 de los móviles (Chile, Argentina) y el 1 antiguo (México).
`external_id`	String	Opcional	Tu propio id para la persona, tal como lo enviaste a POST /contacts.

Ejemplo de solicitud

bash

curl -X GET "https://api.eclecticlabs.com/api/external/v2/contacts?email=john%40doe.com&phone=56912345678" \
  -H "X-API-Key: ek_live_your_api_key_here"

Ejemplo de respuesta

json

{
  "results": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "first_name": "John",
      "last_name": "Doe",
      "email": "john@doe.com",
      "phone_number": "56912345678",
      "external_id": "crm-10482",
      "created_at": "2026-03-04T15:22:10Z"
    }
  ]
}

Notas

Envía al menos uno de email, phone o external_id. La respuesta incluye todos los contactos que coinciden con cualquiera de ellos (lógica OR), del más antiguo al más nuevo, hasta 50.
Los emails y teléfonos conservados como alias tras una unificación también coinciden, así que un duplicado unificado antes sigue resolviendo al contacto que quedó.
external_id es null en los contactos que nunca recibieron uno.
Posibles errores: 400 (ningún identificador enviado, o uno inválido), 401 (API key inválida o ausente).