> ## Documentation Index
> Fetch the complete documentation index at: https://docs.threetone.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Conversation users

> Find end users represented in saved conversations and inspect their contact history through the API.

Conversation users are people represented in your conversation history. They are separate from workspace members who manage Threetone.

<Note>
  Use the API for this workflow. The Users dashboard currently displays sample data and is not a view of your saved customer records.
</Note>

You need workspace access, a permitted API key, and saved conversations with an end-user identity.

<Steps>
  <Step title="Choose the population" id="users-choose-population">
    [List conversation users](/api-reference/agents-platform/list-conversation-users) with an optional `agent_id`, `branch_id`, or `call_start_after_unix` and `call_start_before_unix` window. These filters determine which conversations contribute to the counts.
  </Step>

  <Step title="Find an identity" id="users-find-identity">
    Set `search` to the complete `user_id` for an exact match. It is not a partial name or email search. Sort by `last_contact_unix_secs` or `conversation_count`, and follow `next_cursor` while `has_more` is true.
  </Step>

  <Step title="Inspect the contributing history" id="users-inspect-history">
    Review `conversation_count`, first and last contact times, and `last_contact_conversation_id`. Use [List conversations](/api-reference/agents-platform/list-conversations) with `user_id` to inspect the underlying records.
  </Step>
</Steps>

Identity comes from the stored end-user ID, with legacy fallbacks to initiation data or a caller number. Treat it as a conversation identifier, not verified ownership of a phone number or account.

<AccordionGroup>
  <Accordion title="Does this create a customer profile?" id="users-faq-profile">No. The list groups existing conversation records. It does not create a separate contact or workspace membership.</Accordion>
  <Accordion title="Why is sentiment missing?" id="users-faq-sentiment">Only stored, valid sentiment results contribute. Check `scored_conversation_count` before interpreting averages.</Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.