---
title: "Voice Lead Briefing"
method: GET
path: "/api/voice/leads/{lead_id}"
---

# Voice Lead Briefing

`GET /api/voice/leads/{lead_id}`

## Request

- Base URL: `https://api.every.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.every.ai/api/voice/leads/{lead_id}`
- Auth: none declared

Why this lead was recommended, as a short spoken briefing.

Same contract as `/voice/deals/{deal_id}`: org-scoped by the token, 404
(not an empty 200) when there is no such PENDING lead here, so the app can
tell "gone / already approved" from "nothing to say" and fall back to the
agent. Approve and reject are NOT here -- the app calls the existing
`POST /api/prospecting/deals/{id}/approve` and `/dismiss` routes, which are
the single chokepoints for those state changes.

## Path parameters

- `lead_id` string, required

## Query parameters

- `user_id` string
- `org_id` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-15** `18ebf474f2a0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/every/apis/every-api/changes/api/voice/leads/:lead_id/get.md)

---

[API](https://skmtc.dev/every/apis/every-api.md) - [All operations](https://skmtc.dev/every/apis/every-api/llms.txt) - [OpenAPI document](https://skmtc.dev/every/apis/every-api/revisions/291866eedd52?raw)