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

# List all conversations linked to a specific prospect

> List all conversations linked to a specific prospect



## OpenAPI

````yaml openapi.json get /v1/prospects/{prospect_id}/conversations
openapi: 3.1.0
info:
  title: Trata AI API
  description: >-
    Human like conversation to answer calls, drive engagement, automate
    follow-ups & schedule bookings 24/7  with end to end integrations ensuring
    you never miss a sales enquiry.
  version: 1.0.0
servers:
  - url: https://api.trata.ai
    description: Production
  - url: http://localhost:8000
    description: Development
security: []
paths:
  /v1/prospects/{prospect_id}/conversations:
    get:
      tags:
        - ConversationProspectLink
      summary: List all conversations linked to a specific prospect
      description: List all conversations linked to a specific prospect
      operationId: listConversationsOfProspectsV1
      parameters:
        - name: prospect_id
          in: path
          required: true
          schema:
            type: string
            description: ID of the prospect
            title: Prospect Id
          description: ID of the prospect
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Conversation-Output'
                title: Response Listconversationsofprospectsv1
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    Conversation-Output:
      properties:
        id:
          type: string
          title: Id
        orgId:
          type: string
          title: Orgid
        prospectId:
          anyOf:
            - type: string
            - type: 'null'
          title: Prospectid
        source:
          type: string
          title: Source
        sourceType:
          type: string
          title: Sourcetype
        aiAgentId:
          type: string
          title: Aiagentid
        transcriptText:
          anyOf:
            - items:
                $ref: '#/components/schemas/DialogLine'
              type: array
            - type: 'null'
          title: Transcripttext
        transcriptSummary:
          anyOf:
            - type: string
            - type: 'null'
          title: Transcriptsummary
        transcriptRecordingUrl:
          anyOf:
            - type: string
            - type: 'null'
          title: Transcriptrecordingurl
        timestampStart:
          type: string
          format: date-time
          title: Timestampstart
        timestampEnd:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Timestampend
        conversationAnalytics:
          anyOf:
            - $ref: '#/components/schemas/ConversationAnalyticsModel'
            - type: 'null'
          description: Analytics of the conversation
        status:
          type: string
          title: Status
        createdBy:
          type: string
          title: Createdby
        createdAt:
          type: string
          format: date-time
          title: Createdat
        updatedBy:
          type: string
          title: Updatedby
        updatedAt:
          type: string
          format: date-time
          title: Updatedat
      type: object
      required:
        - status
      title: Conversation
      description: >-
        Any conversation happening between the end user and assistant is stored
        in this table
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    DialogLine:
      properties:
        speaker:
          type: string
          title: Speaker
        message:
          type: string
          title: Message
        timestamp:
          type: string
          format: date-time
          title: Timestamp
        message_id:
          type: string
          title: Message Id
      type: object
      required:
        - speaker
        - message
        - timestamp
        - message_id
      title: DialogLine
    ConversationAnalyticsModel:
      properties:
        summary:
          type: string
          title: Summary
          description: >-
            Summary of the conversation happened with important details on the
            conversation. The summary should be concise and to the point. It
            should contain the important details of the conversation like name,
            phone number, email, address and any other details shared by the
            user.
        action_items:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Action Items
          description: >-
            List of action items and the next steps to be performed from the
            conversation details.
        is_audio_consent_given:
          type: boolean
          title: Is Audio Consent Given
          description: >-
            If the user has given consent to store the audio of the
            conversation. Unless the user explicitly says yes, this should be
            false.
        email_address_of_caller:
          anyOf:
            - type: string
            - type: 'null'
          title: Email Address Of Caller
          description: >-
            Extracted email address of the caller from the conversation details.
            Email should be a valid email address format
        name_of_caller:
          anyOf:
            - type: string
            - type: 'null'
          title: Name Of Caller
          description: Extracted name of the caller from the conversation details.
        phone_number_of_caller:
          anyOf:
            - type: string
            - type: 'null'
          title: Phone Number Of Caller
          description: Extracted phone number of the caller from the conversation details.
        address_of_caller:
          anyOf:
            - type: string
            - type: 'null'
          title: Address Of Caller
          description: Extracted address of the caller from the conversation details.
        sentiment_of_caller:
          allOf:
            - $ref: '#/components/schemas/CallSentiment'
          description: Sentiment of the caller based on the conversation details.
        prospectStatus:
          anyOf:
            - $ref: '#/components/schemas/ProspectStatus'
            - type: 'null'
          description: Status of the prospect after this conversation.
      additionalProperties: false
      type: object
      required:
        - summary
        - action_items
        - is_audio_consent_given
        - email_address_of_caller
        - name_of_caller
        - phone_number_of_caller
        - address_of_caller
        - sentiment_of_caller
        - prospectStatus
      title: ConversationAnalyticsModel
      description: Expected output of the post conversation task
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    CallSentiment:
      type: string
      enum:
        - positive
        - negative
        - neutral
      title: CallSentiment
    ProspectStatus:
      type: string
      enum:
        - NEW
        - GENERAL_ENQUIRY
        - SCHEDULED_CALLBACK_WITH_BOT
        - SCHEDULED_APPOINTMENT_WITH_PERSON
        - SCHEDULED_APPOINTMENT_FOR_SERVICE
        - NOT_INTERESTED
        - PRODUCT_ORDER_PLACED
        - SERVICE_ORDER_PLACED
      title: ProspectStatus
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````