---
title: "Get Conversations Info"
method: GET
path: "/conversations/{id}"
tags: ["Conversations"]
---

# Get Conversations Info

`GET /conversations/{id}`

This endpoint consumes **1 Apollo credit per conversation** if the conversation has AI insights. If the conversation doesn't have AI insights, the request consumes **0 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 Get Conversation Info endpoint to retrieve the full details of a single conversation by its ID.<br><br>To get a conversation's ID, refer to <a href="https://docs.apollo.io/docs/search-conversations">Search Conversations</a>.

## Path parameters

- `id` string, required

## Response `200`

200

- object
  - `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.
  - `pushed_to_crm` boolean — Whether the conversation has been pushed to a CRM.
  - `account_ids` string[] — IDs of accounts associated with the conversation.
  - `label_id_names` string[] — Map of label IDs to label names associated with the conversation.
  - `is_shared_conversation` boolean — Whether the conversation has been shared.
  - `opportunity_ids` string[] — IDs of opportunities associated with the conversation.
  - `comment_count` integer — Number of comments on the conversation.
  - `failure_code` string, nullable — Error code if the conversation processing failed. Returns <code>null</code> if no failure occurred.
  - `bot_call_ended_reason` string, nullable — Reason the bot call ended. Returns <code>null</code> if not applicable.
  - `conversation_type` 'video_conference' | 'phone_call' — Type of conversation.
  - `is_clip` boolean — Whether the conversation is a clip.
  - `video_recording` object — Video recording details for the conversation.
    - `type_cd` string — Video recording type code.
    - `url` string — URL of the video recording.
    - `state_cd` string — Processing state code of the video recording.
  - `audio_recording` object — Audio recording details for the conversation.
    - `url` string — URL of the audio recording.
  - `transcript` object[] — Transcript of the conversation.
  - `participants` object — Participants in the conversation, grouped by internal and external.
    - `internal` object[] — Internal participants.
    - `external` object — External participants.
  - `opportunities` object[] — Opportunities associated with the conversation.
    - `id` string — Opportunity ID.
    - `name` string — Opportunity name.
    - `amount` number, nullable — Opportunity amount.
    - `closed_date` string, nullable — Close date (ISO 8601).
    - `created_at` string — Creation timestamp (ISO 8601).
    - `last_sync` string, nullable — Last CRM sync timestamp (ISO 8601).
    - `account` object, nullable — Account this opportunity belongs to.
      - `id` string — Account ID.
      - `name` string — Account name.
    - `crm_record_url` string, nullable — Deep link to the opportunity in the connected CRM.
    - `opportunity_crm_id` string, nullable — Opportunity ID in the connected CRM.
    - `opportunity_stage_id` string, nullable — ID of the opportunity stage.
    - `stage_name` string, nullable — Display name of the opportunity stage.
    - `owner_id` string, nullable — User ID of the opportunity owner.
    - `initial_opportunity_stage_id` string, nullable — Original opportunity stage ID when the conversation was first associated.
  - `playlist_clip_ids` string[], nullable — IDs of the playlist clips associated with the conversation.

## Other responses

- `404` — 404
- `422` — 422

---

[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)
