---
title: "Conversations of a Local Services lead"
method: GET
path: "/v1/ads/local-services/leads/{leadId}/conversations"
tags: ["Ad Insights"]
---

# Conversations of a Local Services lead

`GET /v1/ads/local-services/leads/{leadId}/conversations`

Conversation entries of one Local Services lead: phone calls (duration,
recording URL) and messages (text, attachment URLs), oldest first. Read
live from `local_services_lead_conversation`, always scoped to a single
lead. Call-recording URLs require read access on the Google Ads account.
Draws on the shared Google Ads operations budget.

## Path parameters

- `leadId` string, required

## Query parameters

- `accountId` string, required
- `customerId` string
- `pageToken` string

## Response `200`

Lead conversations

- object
  - `customerId` string
  - `data` object[]
    - `id` string, nullable
    - `channel` string, nullable — PHONE_CALL / MESSAGE / SMS / EMAIL / WHATSAPP / ADS_API.
    - `participantType` string, nullable — ADVERTISER or CONSUMER.
    - `eventDateTime` string, nullable
    - `phoneCall` object, nullable — Only on PHONE_CALL entries.
      - `callDurationMillis` integer, nullable
      - `callRecordingUrl` string, nullable
    - `message` object, nullable — Only on message-channel entries.
      - `text` string, nullable
      - `attachmentUrls` string[]
  - `paging` object
    - `nextPageToken` string, nullable — Null when the last page was returned.

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `429` — Google Ads operations budget exhausted; retry later.
- `501` — Only available on Google Ads accounts

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/revisions/19fd2b70854e/schema)