Skip to main content
GET
/
leads
/
{id}
Get lead
curl --request GET \
  --url https://api.getnexor.ai/api/public/leads/{id} \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "lead": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "first_name": "Carlos",
    "last_name": "Lopez",
    "email": "carlos@example.com",
    "phone": "+56912345678",
    "source": "api",
    "company": "Stark Industries",
    "title": null,
    "metadata": {
      "estado_lead": "calificado"
    },
    "tags": [],
    "campaign": {
      "id": "uuid",
      "name": "Q1 Campaign"
    },
    "active_workflow_run": {
      "id": "uuid",
      "workflow_id": "uuid",
      "is_active": true,
      "human_takeover": false,
      "cadence_state": "active",
      "run_status": "running",
      "workflow": {
        "id": "uuid",
        "name": "Sales Pipeline",
        "goal_type": "appointment"
      },
      "current_status": {
        "id": "uuid",
        "key": "contacted",
        "label": "Contacted",
        "category": "active"
      }
    },
    "created_at": "2026-02-10T12:00:00Z",
    "updated_at": "2026-02-10T12:00:00Z"
  },
  "variables": {
    "edad": {
      "value": 35,
      "value_text": "35",
      "confidence": 0.95,
      "updated_at": "2026-02-10T13:00:00Z"
    },
    "broker_asociado": {
      "value": "Juan Perez",
      "value_text": "Juan Perez",
      "confidence": 0.9,
      "updated_at": "2026-02-10T13:05:00Z"
    }
  }
}

Authorizations

X-API-Key
string
header
required

API key for authentication. Keys are prefixed with nxr_live_.

Path Parameters

id
string<uuid>
required

Lead ID

Response

Lead retrieved successfully

Full lead object with related data (campaign, workflow, status).

id
string<uuid>
first_name
string
last_name
string | null
email
string<email> | null
phone
string | null
source
string
company
string | null
title
string | null
metadata
object

Arbitrary key-value data stored on the lead

campaign
object
activeWorkflowRun
object

The lead's currently active workflow run, if any

workflow
object

The workflow associated with the active run

currentStatus
object

Current workflow status of the lead

assigned_user
object

Assigned user. Only returned when the active workflow has goal_type = 'appointment'.

created_at
string<date-time>
Last modified on June 18, 2026