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

# List Conversations

> List all active conversations

Retrieve a list of all active conversations in the system.

### Response

Returns an array of conversation objects, each containing:

<ResponseField name="conversation_id" type="string">
  Unique identifier for the conversation
</ResponseField>

<ResponseField name="response" type="string">
  Last response from the agent
</ResponseField>

<ResponseField name="status" type="string">
  Current status of the conversation
</ResponseField>

<ResponseField name="customer_info" type="object">
  Customer information for this conversation

  <Expandable title="properties">
    <ResponseField name="name" type="string">Customer's name</ResponseField>
    <ResponseField name="phone" type="string">Contact phone number</ResponseField>
    <ResponseField name="address" type="string">Service address</ResponseField>
    <ResponseField name="issue" type="string">Description of the issue</ResponseField>
    <ResponseField name="role" type="string">Customer's role (optional)</ResponseField>
    <ResponseField name="priority" type="string">Ticket priority (optional)</ResponseField>
    <ResponseField name="type" type="string">Request type (optional)</ResponseField>
    <ResponseField name="date_time" type="string">Timestamp of conversation</ResponseField>
    <ResponseField name="submission_date_time" type="string">When ticket was submitted (optional)</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="is_complete" type="boolean">
  Whether all required information has been collected
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl 'https://api.clever.nivara.io/conversations'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  [
    {
      "conversation_id": "conv_123abc456def",
      "response": "Thank you for providing all the information. I'll create a maintenance ticket for you now.",
      "status": "completed",
      "customer_info": {
        "name": "John Smith",
        "phone": "+1234567890",
        "address": "123 Main St, City",
        "issue": "Heating system not working",
        "role": "tenant",
        "priority": "high",
        "type": "maintenance",
        "date_time": "2024-03-21T10:30:00Z",
        "submission_date_time": "2024-03-21T10:35:00Z"
      },
      "is_complete": true
    },
    {
      "conversation_id": "conv_789xyz012uvw",
      "response": "Could you please describe the issue you're experiencing?",
      "status": "in_progress",
      "customer_info": {
        "name": "Jane Doe",
        "phone": "+0987654321",
        "address": "456 Oak Ave, Town",
        "issue": null,
        "role": null,
        "priority": null,
        "type": null,
        "date_time": "2024-03-21T10:40:00Z",
        "submission_date_time": null
      },
      "is_complete": false
    }
  ]
  ```
</ResponseExample>
