> ## Documentation Index
> Fetch the complete documentation index at: https://docs.deltalead.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Obtener un lead por ID — endpoint de la API REST de DeltaLead

> Recuperar todos los datos de un lead por ID: datos de contacto, score de IA, intención de compra, vehículo de interés, estado, asignación y marcas de tiempo.

Este endpoint devuelve el perfil completo de un lead —datos de contacto, score asignado por IA, intención de compra, estado actual, vehículo de interés y todas las marcas de tiempo— a partir de su identificador único en la ruta de la URL. Sirve para mostrar el detalle de un lead dentro de herramientas propias, sincronizar registros individuales con un CRM externo o consultar el estado de calificación más reciente antes de ejecutar una acción.

## Endpoint

```text theme={null}
GET https://platform-api.deltalead.ai/v1/leads/{id}
```

## Parámetros de ruta

<ParamField path="id" type="string" required>
  Identificador único del lead a recuperar. Los IDs de lead llevan el prefijo `lead_`, p. ej. `lead_abc123`. Se pueden obtener desde el endpoint [Listar leads](/api-reference/leads/list) o desde los payloads de webhook.
</ParamField>

## Ejemplo de solicitud

```bash cURL theme={null}
curl https://platform-api.deltalead.ai/v1/leads/lead_abc123 \
  -H "X-API-Key: YOUR_API_KEY"
```

## Respuesta

Una solicitud exitosa devuelve HTTP `200 OK` con el objeto lead completo.

```json 200 OK theme={null}
{
  "id": "lead_abc123",
  "name": "María García",
  "phone": "+5491155551234",
  "email": "maria@example.com",
  "channel": "whatsapp",
  "vehicle_interest": "Toyota Hilux SRX 2024",
  "score": 87,
  "intent": "purchase_30_days",
  "status": "qualified",
  "assigned_to": "user_xyz789",
  "created_at": "2024-03-10T14:22:00Z",
  "updated_at": "2024-03-11T09:05:33Z",
  "last_activity_at": "2024-03-11T09:05:33Z",
  "organization_id": "org_00112233"
}
```

### Campos de la respuesta

<ResponseField name="id" type="string">
  Identificador único del lead, con el prefijo `lead_`.
</ResponseField>

<ResponseField name="name" type="string">
  Nombre completo del lead tal como se captó desde el canal de origen o como se indicó al crearlo.
</ResponseField>

<ResponseField name="phone" type="string">
  Número de teléfono del lead en formato E.164, p. ej. `+5491155551234`.
</ResponseField>

<ResponseField name="email" type="string | null">
  Dirección de email del lead. `null` si no se proporcionó.
</ResponseField>

<ResponseField name="channel" type="string">
  Canal por el que el lead contactó por primera vez al concesionario. Uno de `whatsapp`, `facebook`, `instagram`, `mercadolibre`, `web_form`, `email`, `phone`.
</ResponseField>

<ResponseField name="vehicle_interest" type="string | null">
  Modelo o descripción del vehículo por el que el lead manifestó interés, según lo identificó el agente de IA. `null` si todavía no se determinó.
</ResponseField>

<ResponseField name="score" type="integer">
  Score de calidad del lead generado por IA, de `0` (frío) a `100` (altamente calificado), calculado a partir de la intención de compra, las señales de presupuesto y los indicadores de urgencia extraídos de la conversación.
</ResponseField>

<ResponseField name="intent" type="string">
  Categoría de intención de compra asignada por el agente de IA. Una de:

  * `purchase_30_days` — urgencia alta, compra probable dentro de los 30 días
  * `purchase_90_days` — urgencia moderada, compra dentro del trimestre
  * `browsing` — explorando opciones, sin un plazo definido
  * `unknown` — señal insuficiente para clasificar
</ResponseField>

<ResponseField name="status" type="string">
  Estado actual del lead dentro de su ciclo de vida. Uno de `new`, `in_conversation`, `qualified`, `assigned`, `closed`, `lost`.
</ResponseField>

<ResponseField name="assigned_to" type="string | null">
  ID de usuario del asesor de ventas al que está asignado el lead. `null` si el lead no fue asignado.
</ResponseField>

<ResponseField name="created_at" type="string">
  Marca de tiempo ISO 8601 del momento en que el lead se captó en DeltaLead.
</ResponseField>

<ResponseField name="updated_at" type="string">
  Marca de tiempo ISO 8601 del cambio más reciente en cualquier campo de este lead.
</ResponseField>

<ResponseField name="last_activity_at" type="string">
  Marca de tiempo ISO 8601 de la interacción más reciente —mensaje, llamada o cambio de estado— registrada para este lead.
</ResponseField>

<ResponseField name="organization_id" type="string">
  Identificador único de la organización de DeltaLead (concesionario) propietaria de este registro de lead.
</ResponseField>

## Errores

<Accordion title="404 — Lead no encontrado">
  Se devuelve cuando no existe ningún lead con el `id` indicado dentro de la organización.

  ```json 404 Not Found theme={null}
  {
    "error": {
      "code": "lead_not_found",
      "message": "No lead with id 'lead_abc123' was found in your organization.",
      "status": 404
    }
  }
  ```

  Conviene verificar que el valor de `id` sea correcto y pertenezca a la organización. Los IDs de lead correspondientes a la cuenta de otra organización también devuelven `404`.
</Accordion>