Lead
v0.1.0A single sales lead: one shopper's expression of interest in buying, leasing, selling, or trading a vehicle, captured from any channel and tracked through the CRM lifecycle. This entity is the modernized, typed equivalent of an entire ADF (Auto-lead Data Format) XML lead payload — an ADF document describes exactly one lead, so Lead is that document's root object. Field lineage follows ADF throughout: <requestdate> maps to received_at, <prospect status>/@status maps to status + is_resend, <provider> maps to provider, <vehicle interest=...> maps to vehicles_of_interest[].interest, and <timeframe> maps to timeframe. Durable cross-entity relationships (the resolved customer, an assigned salesperson, a scheduled appointment, consent records) are referenced by UUID rather than embedded; the customer's master record lives in the Customer entity, and a lead that converts produces a Deal.
leads.get_leadleads.create_leadleads.search_leads{
"id": "2f7c1e6a-4b3d-4c8e-9a1f-6d5e0b2c9a11",
"source_ids": [
{
"system": "cars.com",
"id": "CDC-88213470",
"sequence": 1
},
{
"system": "dealer-crm",
"id": "LEAD-000451992",
"sequence": 2
}
],
"received_at": "2026-06-28T09:14:22-07:00",
"status": "working",
"substatus": "awaiting_trade_value",
"is_resend": false,
"priority": "high",
"score": 82,
"provider": {
"name": "Cars.com",
"service": "New Car Listings",
"lead_id": "CDC-88213470"
},
"channel": "marketplace",
"sub_source": "Cars.com VDP - 2026 Chevrolet Blazer EV RS",
"campaign": {
"name": "Summer EV Push 2026",
"utm_source": "google",
"utm_medium": "cpc",
"utm_campaign": "blazer-ev-2026-socal",
"gclid": "Cj0KCQjw-abcDEF123gHIjkLMnoPqrsTUvwXyz456"
},
"referrer_url": "https://www.cars.com/vehicledetail/blazer-ev-rs-2026/",
"customer_id": "b91d4f2c-3e57-4a19-8c26-1f0a7b3d9e42",
"contact": {
"name": {
"first": "Marisol",
"middle": "Ann",
"last": "Delgado",
"prefix": "Ms.",
"full": "Marisol Ann Delgado"
},
"emails": [
{
"address": "marisol.delgado@example.com",
"type": "personal",
"is_primary": true,
"verified": true
},
{
"address": "mdelgado@work-example.com",
"type": "work",
"is_primary": false,
"verified": false
}
],
"phones": [
{
"number": "+15125550143",
"type": "mobile",
"is_primary": true,
"sms_capable": true,
"preferred_time": "evening"
},
{
"number": "+15125550188",
"type": "home",
"extension": "0",
"is_primary": false,
"sms_capable": false,
"preferred_time": "any"
}
],
"addresses": [
{
"type": "home",
"lines": [
"4820 Mesa Verde Drive",
"Unit 6"
],
"city": "Austin",
"region": "TX",
"postal_code": "78745",
"country": "US",
"is_primary": true
}
]
},
"vehicles_of_interest": [
{
"interest": "lease",
"vehicle_id": "7c2a9d18-5f60-4b3a-a1c4-8e2f6b0d3a55",
"year": 2026,
"make": "Chevrolet",
"model": "Blazer EV",
"trim": "RS",
"vin": "3GNKBHR40PS123456",
"stock_number": "C26-4471",
"is_new": true,
"target_price": {
"amount": 48990,
"currency": "USD"
},
"payment_target": {
"amount": 579,
"currency": "USD"
}
},
{
"interest": "test_drive",
"year": 2026,
"make": "Chevrolet",
"model": "Equinox EV",
"trim": "2LT",
"is_new": true
}
],
"trade_in": {
"year": 2019,
"make": "Honda",
"model": "CR-V",
"vin": "2HKRW2H85KH512345",
"odometer": 61240,
"estimated_value": {
"amount": 18500,
"currency": "USD"
}
},
"financing": {
"interested": true,
"credit_range": "good",
"budget_monthly": {
"amount": 600,
"currency": "USD"
}
},
"timeframe": {
"description": "Looking to lease within the next 30 days",
"earliest_date": "2026-07-01",
"latest_date": "2026-07-28"
},
"best_time_to_contact": "evening",
"comments": "Interested in the Blazer EV RS in Radiant Red. Would like to know about current lease specials and whether the tax credit applies. Prefer texts over calls.",
"assigned_to_id": "e4a8c6b2-1d90-4f37-b5e8-2a7c9f0d61b3",
"team": "Internet Sales",
"appointment_id": "9d3f7a51-6c28-4e0b-8f14-3b5a2c7d9e60",
"consent_ids": [
"c1b2a3d4-5e6f-4708-9a1b-2c3d4e5f6071",
"d2c3b4a5-6f70-4819-8b2c-3d4e5f607182"
],
"disposition": "in_progress",
"converted_deal_id": "a7e1c9b3-2d84-4f56-9c07-1b8e3a6d5f24",
"created_at": "2026-06-28T09:14:25-07:00",
"updated_at": "2026-06-30T16:42:10-07:00",
"extensions": {
"acme:region_code": "SW-04",
"acme:lead_grade": "A"
}
}