Retrieve a conversion

GET /v1/leads/{lead_id}/conversion

Returns the conversion row of one lead, exactly as the list returns it.

Scope: leads:read

The same row, field visibility included, as GET /v1/campaigns/{campaign_id}/conversions. The lead must belong to a campaign the key may reach and be one the key's member can see in DialEcho, otherwise 404.

Path parameters

Name	Type	Required	Description
`lead_id`	`UUID`	Yes	The lead.

Response

Status: 200 OK

Name	Type	Description
`lead_id`	`UUID`	The lead.
`campaign_id`	`UUID`	The lead's campaign.
`created_at`	`timestamp`	When the lead was created in DialEcho (RFC 3339, UTC).
`contact`	`object`	The lead's details as `GET /v1/leads/{lead_id}` returns them, with the same field visibility: a field the member's role hides is `null`, one it masks comes back masked.
`contact.first_name`	`string \| null`	First name.
`contact.last_name`	`string \| null`	Last name.
`contact.email`	`string \| null`	Email address.
`contact.phone`	`string \| null`	Phone number in E.164 (`+14155550132`); a stored number that is not a valid phone number is returned as stored.
`contact.city`	`string \| null`	City.
`contact.state`	`string \| null`	State.
`contact.postal_code`	`string \| null`	ZIP or postal code.
`contact.email_sha256`	`string \| null`	SHA-256 (lowercase hex) of the email trimmed and lowercased: Meta's hashed `em`. `null` without an email, or unless the member sees the email in full.
`contact.phone_sha256`	`string \| null`	SHA-256 (lowercase hex) of the number's digits with country code and no `+` (`14155550132`): Meta's hashed `ph`. `null` without a valid number, or unless the member sees the phone in full.
`attribution`	`object \| null`	The attribution stored on the lead under the 16 `attribution` keys `POST /v1/leads` accepts (`utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content`, `utm_id`, `adset_id`, `ad_id`, `fbclid`, `fbc`, `fbp`, `gclid`, `meta_event_id`, `page_url`, `form_name`, `referrer`), whether sent through the API or set another way such as an import. Every key is present, `null` when never set. The whole object is `null` when the member's role hides custom fields; when it masks them, set values read `Restricted`.
`milestones`	`object`	How far the lead got. Timestamps are RFC 3339 in UTC; `null` until the lead reaches the milestone.
`milestones.first_call_at`	`timestamp \| null`	When the first outbound call to the lead by one of the campaign's AI agents started: a `POST /v1/calls` call, a campaign or a pipeline agent's call. Calls by your team and calls the lead made are not counted.
`milestones.first_call_outcome`	`string \| null`	How that call went: `reached` (a real conversation), `answered` (picked up but no conversation), `voicemail`, `no_answer` (not answered, busy or not connected) or `in_progress`. One of `in_progress`, `reached`, `answered`, `voicemail`, `no_answer`.
`milestones.appointment_booked_at`	`timestamp \| null`	When the lead's first appointment in the campaign was booked, however it was booked, even if it was later moved or cancelled.
`milestones.appointment_at`	`timestamp \| null`	When the appointment is or was scheduled: the first one that was held; if none was held, the latest one not cancelled; if all were cancelled, the latest one.
`milestones.appointment_status`	`string \| null`	That appointment's status. Attendance your team records decides (shown up is `held`, no-show is `no_show`); otherwise `held` when your team's appointment call reached the lead and `no_show` when your team recorded nobody answered. An unanswered call with nothing recorded leaves it `scheduled`. One of `scheduled`, `held`, `no_show`, `cancelled`.
`milestones.appointment_held_at`	`timestamp \| null`	For a `held` appointment, when the call that reached the lead started; for one only marked as shown up, its scheduled start.
`milestones.closed_at`	`timestamp \| null`	When the card entered the Won stage it is in now (a deal reopened and won again reports the latest win). `null` unless `card.deal_status` is `won`.
`milestones.lost_at`	`timestamp \| null`	The same for a Lost stage. `null` unless `card.deal_status` is `lost`.
`card`	`object \| null`	The card `GET /v1/leads/{lead_id}` returns as `card`, or `null` if the lead has none the member can open: its main card (the deal), or, for a member who may open only a follow-through card of the lead, that card with its own pipeline, stage, `deal_status`, `closed_at` and `lost_at` and the deal value it shares with the main card. Nothing of a card the member may not open is shown. Always shown, whatever the member's field visibility.
`card.id`	`UUID`	The card.
`card.pipeline_id`	`string \| null`	The card's pipeline.
`card.pipeline_name`	`string \| null`	The pipeline's name.
`card.stage`	`string \| null`	Slug of the current stage.
`card.stage_name`	`string \| null`	Name of the current stage.
`card.deal_status`	`string`	`abandoned` when your team marked the deal abandoned, otherwise the outcome set on the card's stage in DialEcho (Won, Lost or Open), whatever the stage is called. A follow-through card the deal moves into after it is won is reported only to a member who may open that card and not the main card. One of `open`, `won`, `lost`, `abandoned`.
`card.deal_value`	`number \| null`	The deal value, shared by the main card and its follow-through cards, or `null`.

Example request

curl

bash

curl "https://development.agencydevworks.ai/v1/leads/aaaaaaaa-0000-4000-8000-000000000002/conversion" \
  -H "Authorization: Bearer dei_your_key"

JavaScript

const response = await fetch("https://development.agencydevworks.ai/v1/leads/aaaaaaaa-0000-4000-8000-000000000002/conversion", {
  headers: {
    "Authorization": "Bearer dei_your_key",
  },
});
const data = await response.json();

Example response

Status: 200 OK

json

{
  "lead_id": "aaaaaaaa-0000-4000-8000-000000000002",
  "campaign_id": "cccccccc-0000-4000-8000-000000000001",
  "created_at": "2026-11-03T10:21:07Z",
  "contact": {
    "first_name": "Sam",
    "last_name": null,
    "email": "sam@example.com",
    "phone": "+18035550142",
    "city": null,
    "state": "SC",
    "postal_code": null,
    "email_sha256": "cd25a6171969f2a3c6e35c7667e3908ef1bd2424241db04411a0eec454ca6c16",
    "phone_sha256": "70d177f4d52fc4982e5a28ed456060c15b9e4654a415c25be1eb9ade17a0a2ea"
  },
  "attribution": {
    "form_name": "quote-step-1",
    "page_url": "https://www.example.com/get-a-quote",
    "referrer": null,
    "utm_source": "google",
    "utm_medium": "cpc",
    "utm_campaign": "fall-promo",
    "utm_term": null,
    "utm_content": null,
    "utm_id": null,
    "adset_id": null,
    "ad_id": null,
    "fbclid": null,
    "fbc": null,
    "fbp": null,
    "gclid": "Cj0KCQexampleGclid",
    "meta_event_id": null
  },
  "milestones": {
    "first_call_at": "2026-11-03T10:21:30Z",
    "first_call_outcome": "voicemail",
    "appointment_booked_at": null,
    "appointment_at": null,
    "appointment_status": null,
    "appointment_held_at": null,
    "closed_at": null,
    "lost_at": null
  },
  "card": {
    "id": "dddddddd-0000-4000-8000-000000000001",
    "pipeline_id": "eeeeeeee-0000-4000-8000-000000000001",
    "pipeline_name": "Sales",
    "stage": "contacted",
    "stage_name": "Contacted",
    "deal_status": "open",
    "deal_value": null
  }
}

Errors

HTTP	Code	When
403	`insufficient_scope`	The key does not have `leads:read`.
404	`not_found`	The lead does not exist or the key cannot reach it.
422	`invalid_request`	`lead_id` is not a UUID.
503	`dependency_unavailable`	The report or the access check is temporarily unavailable. Retry the same request with backoff.

Every endpoint can also answer 401 invalid_api_key, 429 rate_limited and 503 dependency_unavailable. See Errors in the overview.

GET /v1/campaigns/{campaign_id}/conversions · List conversions
GET /v1/leads/{lead_id} · Retrieve a lead

Retrieve a conversion ​

Path parameters ​

Response ​

Example request ​

Example response ​

Errors ​