Obtener contacto

GET https://app.sendapp.ai/api/contacts/{id}

Devuelve un único contacto con todo lo que tiene asociado: etiquetas, campos personalizados (por nombre), estado de baja, responsable, fase del ciclo de vida y contadores de interacción.

Parámetros

2 · 2 obligatorios

apikey obligatorio

Tu API Key (también sirve la cabecera X-API-Key).

id obligatorio

ID del contacto (entero, en la ruta). Usa GET /api/contacts para encontrarlo.

¿Necesitas ayuda con la integración? info@sendapp.live

Solicitud

curl 'https://app.sendapp.ai/api/contacts/42' \
  -H 'X-API-Key: YOUR_API_KEY'

<?php
$ch = curl_init('https://app.sendapp.ai/api/contacts/42');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_API_KEY'],
]);
echo curl_exec($ch);
curl_close($ch);

const res = await fetch('https://app.sendapp.ai/api/contacts/42', {
  method: 'GET',
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
console.log(await res.json());

Respuesta

{
  "status": "success",
  "contact": {
    "id": 42,
    "name": "Mario Rossi",
    "phone": "+393331234567",
    "email": "mario@example.com",
    "birthday": "1985-04-12",
    "tags": ["cliente", "vip"],
    "custom_fields": { "City": "Milano", "Buy status": "active" },
    "metadata": { "source": "api" },
    "opted_out": false,
    "opted_out_at": null,
    "opted_out_reason": null,
    "owner": { "id": 3, "name": "Giulia" },
    "lifecycle_stage": "customer",
    "engagement": {
      "last_interaction_at": 1757260800,
      "last_inbound_at": 1757260800,
      "last_outbound_at": 1757174400,
      "conversations_count": 2,
      "primary_channel": "whatsapp"
    },
    "created_at": 1752400000,
    "updated_at": 1757260800
  }
}

{
  "status": "error",
  "message": "Contact not found."
}