---
title: "Search Conversations"
method: POST
path: "/conversations/search"
tags: ["Conversations"]
---

# Search Conversations

`POST /conversations/search`

This endpoint doesn't consume Apollo credits. Learn more about [API pricing and credits](https://docs.apollo.io/docs/api-pricing).

<a href="https://knowledge.apollo.io/hc/en-us/articles/45998035787533-Use-Conversations">Conversations</a> are prospect video meetings stored in Apollo.<br><br>Use the Search Conversations endpoint to find a list of conversations. Several filters are available to help narrow your search, including by type, account, contact, date range, and more. Each result includes a summary of the conversation.<br><br>This endpoint doesn't include transcripts or recording URLs. Use the conversation ID retrieved from your search to request full details using <a href="https://docs.apollo.io/docs/get-conversations-info">Get Conversations Info</a>.

## Request body

- object
  - `page` integer — Page number for pagination.
  - `num_fetch_result` integer — Maximum number of results to return.
  - `conversation_type` 'video_conference' | 'phone_call' — Filter by dialer calls, or video conference calls.
  - `account_id` string — Filter by account ID.
  - `contact_ids` string[] — Filter by one or more contact IDs.
  - `tag_ids` string[] — Filter by label or tag IDs.
  - `tracker_ids` string[] — Filter by tracker IDs.
  - `organization_ids` string[] — Filter by organization IDs.
  - `date_range` object — Filter by date range.
    - `start` string — Start date (ISO 8601). Apollo uses Greenwich Mean Time (GMT) for all date and time values. <br><br> Example: <code>2024-01-01T00:00:00Z</code>
    - `end` string — End date (ISO 8601). Apollo uses Greenwich Mean Time (GMT) for all date and time values. <br><br> Example: <code>2024-03-31T23:59:59Z</code>
  - `scorecard_template_id` string — Filter by scorecard template ID.
  - `scorecard_max_rating` number — Maximum scorecard rating to include in the results.
  - `sort_by_field` string — Field to sort results by.
  - `enforce_contact_boundary` boolean — When <code>true</code>, restricts results to conversations visible to the specified contacts.

## Response `200`

200

- object
  - `pagination` object — Pagination metadata for the result set.
  - `breadcrumbs` object — Breadcrumbs data associated with the results.
  - `num_fetch_result` integer — Number of results returned.
  - `playlist_clip_ids` string[], nullable — IDs of playlist clips associated with the results.
  - `conversations` object[] — List of conversation summaries matching the search criteria.
    - `id` string — Unique conversation ID.
    - `topic` string — Conversation topic or title.
    - `start_time` string — Conversation start time (ISO 8601). Apollo uses Greenwich Mean Time (GMT) for all date and time values.
    - `duration` integer — Duration of the conversation in seconds.
    - `state` string — Current processing state of the conversation.
    - `host` string — Name of the conversation host.
    - `host_id` string — User ID of the conversation host.
    - `is_private` boolean — Privacy setting of the conversation.
    - `conversation_type` 'video_conference' | 'phone_call' — Filter by dialer calls, or video conference calls.
    - `can_access_conversation` boolean — Whether the authenticated user can access this conversation.
    - `label_id_names` object — Label names associated with the conversation.
    - `participant_names` string[] — Names of the conversation participants.
    - `comment_count` integer — Number of comments on the conversation.
    - `account_names` string[] — Names of associated accounts.
    - `account_ids` string[] — IDs of associated accounts.
    - `organization` object — Organization associated with the result.
      - `domain` string, nullable — Organization domain.
      - `logo_url` string, nullable — Organization logo URL.
    - `participants_info` object[] — Detailed information about conversation participants.
    - `thumbnail_url` string — URL of the conversation thumbnail image.
    - `is_internal` boolean — Whether the conversation is internal.
    - `deals` object[] — Deals associated with the conversation.
      - `id` string — Deal ID.
      - `account_name` string — Name of the associated account.
      - `name` string — Deal name.
      - `opportunity_stage_id` string — ID of the opportunity stage.

## Other responses

- `403` — 403

---

[API](https://skmtc.dev/apollo/apis/apollo-rest-api.md) · [All operations](https://skmtc.dev/apollo/apis/apollo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apollo/apollo-rest-api/revisions/c715a05fa6e2/schema)