Fetch One Lead by ID — DeltaLead REST API Endpoint

Fetch the complete profile of a single lead — including contact details, AI-assigned score, purchase intent, current status, vehicle interest, and all timestamps — by passing its unique identifier in the URL path. Use this endpoint to display lead details inside your own tooling, sync individual records to an external CRM, or check the latest qualification state before taking an action.

Endpoint

GET https://platform-api.deltalead.ai/v1/leads/{id}

Path Parameters

string

required

The unique identifier of the lead to retrieve. Lead IDs are prefixed with lead_, e.g. lead_abc123. You can obtain lead IDs from the List Leads endpoint or from webhook payloads.

Example Request

cURL

curl https://platform-api.deltalead.ai/v1/leads/lead_abc123 \
  -H "X-API-Key: YOUR_API_KEY"

Response

A successful request returns HTTP 200 OK with the full lead object.

200 OK

{
  "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"
}

Response Fields

string

Unique identifier for the lead, prefixed with lead_.

string

Full name of the lead as captured from the source channel or provided at creation.

string

Lead’s phone number in E.164 format, e.g. +5491155551234.

string | null

Lead’s email address. null if not provided.

string

The channel through which the lead first contacted your dealership. One of whatsapp, facebook, instagram, mercadolibre, web_form, email, phone.

string | null

Vehicle model or description the lead expressed interest in, as identified by the AI agent. null if not yet determined.

integer

AI-generated lead quality score from 0 (cold) to 100 (highly qualified), based on purchase intent, budget signals, and urgency indicators extracted from the conversation.

string

Purchase intent bucket assigned by the AI agent. One of:

purchase_30_days — high urgency, likely to buy within 30 days
purchase_90_days — moderate urgency, buying within the quarter
browsing — exploring options, no clear timeline
unknown — not enough signal to classify

string

Current lifecycle status of the lead. One of new, in_conversation, qualified, assigned, closed, lost.

string | null

User ID of the sales advisor this lead is assigned to. null if the lead has not been assigned.

string

ISO 8601 timestamp of when the lead was first captured in DeltaLead.

string

ISO 8601 timestamp of the most recent change to any field on this lead.

string

ISO 8601 timestamp of the most recent interaction — message, call, or status change — recorded for this lead.

string

Unique identifier of the DeltaLead organization (dealership) that owns this lead record.

Errors

404 — Lead not found

Returned when no lead with the given id exists in your organization.

404 Not Found

{
  "error": {
    "code": "lead_not_found",
    "message": "No lead with id 'lead_abc123' was found in your organization.",
    "status": 404
  }
}

Verify that the id value is correct and belongs to your organization. Lead IDs from a different organization’s account will also return 404.

Overview

Leads

Conversations

Agents

Webhooks

Fetch One Lead by ID — DeltaLead REST API Endpoint

Endpoint

Path Parameters

Example Request

Response

Response Fields

Errors

​Endpoint

​Path Parameters

​Example Request

​Response

​Response Fields

​Errors

Endpoint

Path Parameters

Example Request

Response

Response Fields

Errors