# Conversations

**Conversations API:** Search the sales conversations recorded by Lusha Conversations for your account, and fetch speaker-attributed transcripts.

Search Conversations returns each conversation's metadata, AI summary, action items, risks, objections, competitor mentions, coaching analysis, and chapters — transcripts are not included. Fetch the transcript for a single conversation separately.

**Two search modes on one contract:**
- **Keyword mode** — supply `query` to rank conversations by transcript content. All other filters are ignored.
- **Filter mode** — omit `query` and supply the structural filters (dates, contact names, company domains, meeting titles).

Only conversations belonging to your account whose post-call processing has completed are returned. `summary`, `coaching`, and `chapters` come from an asynchronous pipeline and are `null`/empty until it has run — a `null` summary means "analysis not ready yet", not "nothing found".

> **Billing:** Search charges 1 credit per block of up to 25 conversations returned (via `ci_meeting_data_export`); a request that returns nothing is free. Transcript charges 1 credit per successful request (via `ci_transcript_analysis`); a `404` is never charged. While the relevant action isn't yet seeded on your account's pricebook, the endpoint stays free (`billing.creditsCharged` is `0`).


## Search Conversations

 - [POST /v3/account/conversations/search](https://docs.lusha.com/apis/openapi/conversations/searchconversations.md): Search the sales conversations recorded by Lusha Conversations for your account. Returns each conversation's metadata, AI summary, action items, risks, objections, competitor mentions, coaching analysis, and chapters. Transcripts are not included — fetch those from Get Conversation Transcript.

Two modes on the same contract:
- Keyword mode — supply query to rank conversations by transcript content. All other filters are ignored.
- Filter mode — omit query and supply the structural filters.

Both modes return the same response shape. An empty body is valid and returns the first page of the account's conversations.

Validation notes:
- companyDomains matches on domain, not display name. Resolve a company name to a domain first (e.g. via Search Companies).
- dateFrom / dateTo accept date-only YYYY-MM-DD values. Datetimes, reduced precision (2026, 2026-01), basic format (20260101), and impossible dates (2026-02-31) are rejected with 400.
- pageSize above 100 is rejected with 400 — it is not silently clamped.
- conversationIds that don't exist, are still processing, or belong to another account are omitted from the response rather than erroring.

> Billing: 1 credit per block of up to 25 conversations returned (1–25 = 1, 26–50 = 2, 51–75 = 3, 76–100 = 4), via ci_meeting_data_export. Charged on results returned, not the page size requested. A request that returns nothing is free. While ci_meeting_data_export isn't seeded on your account's pricebook, the endpoint stays free (billing.creditsCharged is 0).

> Note: summary, coaching, and chapters come from an asynchronous post-call pipeline. A null summary on a recent conversation means analysis isn't ready yet, not "nothing found". A null severity on a risk or objection means the pipeline didn't assess it — do not read it as "low".

## Get Conversation Transcript

 - [GET /v3/account/conversations/{conversationId}/transcript](https://docs.lusha.com/apis/openapi/conversations/getconversationtranscript.md): Returns the speaker-attributed, timestamped transcript of a single conversation. Get the conversationId from Search Conversations.

No request body and no query parameters.

> Billing: 1 credit per successful request via ci_transcript_analysis, including repeat requests for the same conversation. A 404 is never charged. While ci_transcript_analysis isn't seeded on your account's pricebook, the endpoint stays free.

> Note: A single 404 covers all three cases — the conversation doesn't exist, its processing hasn't completed, or it belongs to another account. Transcripts can be long; when feeding one to an LLM, budget for it or summarize it (Search Conversations already returns the summary, chapters, and coaching without the transcript).