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

# Get Contact Conversations

Retrieves a paginated list of contact conversations associated with the given user.

Supports optional search, pagination, and filtering by conversation status. This endpoint is commonly used to display a user's contact list in messaging interfaces.

### Parameters:

* **user\_email\_id** *(required)*
* Your Chatzy AI account email ID.
* **search** *(optional)* - Filter contacts by name, email, phone number or iframe user ID.
* **limit** *(optional)* - Number of contacts to return per page (default: 10, min: 1, max: 100).
* **offset** *(optional)* - Number of contacts to skip for pagination (default: 0).
* **filter** *(optional)* - Filter by conversation status:
* `all` - All conversations (default)
* `unread` - Only conversations with unread messages
* `live` - Active/live conversations


## OpenAPI

````yaml get /get_contact_conversations
openapi: 3.0.0
info:
  title: Chatzy AI API
  version: 1.0.0
  description: >-
    Chatzy AI REST API for messaging, contact conversations, and agent
    interactions.
  contact:
    name: Chatzy
    url: https://chatzy.ai
    email: support@chatzy.ai
servers:
  - url: https://vevdoh3hve.execute-api.us-east-1.amazonaws.com/prod
    description: Production Server
security: []
tags:
  - name: Authentication
    description: Authentication to access the API
  - name: Contact Conversations
    description: Get contact conversations
  - name: Conversational AI Agent Interactions
    description: Interact with the conversational AI agent
  - name: Authorized iframe Access
    description: APIs for authorized iframe access
paths:
  /get_contact_conversations:
    get:
      tags:
        - Contact Conversations
      summary: Get Contact Conversations
      parameters:
        - name: user_email_id
          in: query
          required: true
          schema:
            type: string
          description: Email ID of the user whose contacts should be fetched.
        - name: search
          in: query
          required: false
          schema:
            type: string
          description: Search by contact name, email, phone number or iframe user id.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 10
          description: Number of results to return (min 1, max 100).
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            default: 0
          description: Number of results to skip.
        - name: filter
          in: query
          required: false
          schema:
            type: string
            enum:
              - all
              - unread
              - live
            default: all
          description: 'Filter conversation status: all, unread, or live.'
      responses:
        '200':
          description: A list of contacts for whom there is a conversation.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      data:
                        type: object
                        properties:
                          contacts:
                            type: array
                            items:
                              type: object
                              properties:
                                contact_id:
                                  type: string
                                contact_name:
                                  type: string
                                phone_number:
                                  type: string
                                email:
                                  type: string
                                conversation_status:
                                  type: string
                                assigned_to:
                                  type: string
                                unread_message_count:
                                  type: string
                                latest_message_time:
                                  type: string
                                  format: date-time
                                channels:
                                  type: array
                                  items:
                                    type: string
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Use the `idToken` retrieved from `/get_id_token` as the Bearer token.

````