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

# List event records for a conversation.

> Lists event records for one conversation with paging, including notes, messages, calls, and follow-up history.



## OpenAPI

````yaml /openapi.json post /events/conversations/{conversationId}
openapi: 3.0.4
info:
  title: Leadping API
  description: >-
    Leadping API for lead intake, messaging, calling, automations, billing,
    business settings, and compliant lead communication workflows.
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  version: v1
servers:
  - url: https://api.leadping.ai
    description: Production
security: []
tags:
  - name: Analytics
  - name: Automations
  - name: Contact
  - name: Conversations
  - name: Dispositions
  - name: Feedback
  - name: Leads
  - name: LeadStatuses
  - name: Notifications
  - name: OutboundDelivery
  - name: Sources
  - name: Suppressions
  - name: Tags
  - name: Users
  - name: Calls
  - name: PhoneNumbers
  - name: Sms
  - name: Telephony
  - name: UserDataExports
  - name: CallEvents
  - name: Events
  - name: SmsEvents
  - name: Businesses
  - name: PaymentMethods
  - name: Transactions
  - name: Usage
  - name: Wallets
paths:
  /events/conversations/{conversationId}:
    post:
      tags:
        - Events
      summary: List event records for a conversation.
      description: >-
        Lists event records for one conversation with paging, including notes,
        messages, calls, and follow-up history.
      operationId: Events_GetAllForConversation
      parameters:
        - name: conversationId
          in: path
          description: The ID of the conversation.
          required: true
          schema:
            type: string
      requestBody:
        description: Pagination, filtering, and sorting options.
        content:
          application/json:
            schema:
              allOf:
                - $ref: '#/components/schemas/RequestDataOptions'
              description: >-
                Options for flexible, efficient, and explicit querying in Cosmos
                DB or similar repositories.
          application/*+json:
            schema:
              allOf:
                - $ref: '#/components/schemas/RequestDataOptions'
              description: >-
                Options for flexible, efficient, and explicit querying in Cosmos
                DB or similar repositories.
        required: true
      responses:
        '200':
          description: Events for the conversation were successfully retrieved.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/PagedResultOfEventTableRow'
                description: >-
                  A generic container for paginated results returned to the
                  client.
        '400':
          description: The request was invalid or malformed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
components:
  schemas:
    RequestDataOptions:
      type: object
      properties:
        pageSize:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: Maximum items to return in one page
          format: int32
        continuationToken:
          type: string
          description: >-
            Opaque Cosmos DB continuation token. ‑ on the **first** request. ‑
            Client must echo back the NextToken it received from the previous
            page.
          nullable: true
        orderBy:
          type: array
          items:
            allOf:
              - $ref: '#/components/schemas/OrderByOption'
            description: An object for ordering during querying
          description: List of sort instructions, in priority order.
          nullable: true
        includeCount:
          type: boolean
          description: Whether to include the total count in the response (for pagination).
          nullable: true
        search:
          type: string
          description: The search term to filter results (applied to ).
          nullable: true
        searchFields:
          type: array
          items:
            type: string
          description: >-
            The list of fields to apply the Search term to (must be string
            properties).
          nullable: true
        filters:
          type: array
          items:
            allOf:
              - $ref: '#/components/schemas/ExactMatchFilter'
            description: >-
              A generic object for handling exact match filtering during
              querying
          description: Key-value exact match filters (e.g., Status = Active).
          nullable: true
        rangeFilters:
          type: array
          items:
            allOf:
              - $ref: '#/components/schemas/RangeFilter'
            description: A generic object for handling range filtering during querying
          description: Advanced range-based filters (e.g., Price > 50 and Price <= 200).
          nullable: true
      description: >-
        Options for flexible, efficient, and explicit querying in Cosmos DB or
        similar repositories.
    PagedResultOfEventTableRow:
      type: object
      properties:
        items:
          type: array
          items:
            allOf:
              - $ref: '#/components/schemas/EventTableRow'
            description: >-
              List item schema for Leadping API event timeline table row results
              shown in searchable tables.
          description: The subset of items returned for the current page.
        pageSize:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: >-
            The number of items returned per page in the response. This may
            reflect the client's requested page size, or a server-defined
            default or limit.
          format: int32
        totalCount:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: >-
            The total number of items that match the query across all pages. May
            be null if the count is not computed or not applicable (e.g., in
            continuation-based pagination).
          format: int32
          nullable: true
        continuationToken:
          type: string
          description: >-
            Opaque storage continuation token. ‑ `null` → the current page was
            the last page.
          nullable: true
      description: A generic container for paginated results returned to the client.
    ProblemDetails:
      type: object
      properties:
        type:
          type: string
          description: URI reference that identifies the problem type.
          nullable: true
        title:
          type: string
          description: Short, human-readable summary of the problem.
          nullable: true
        status:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: HTTP status code returned for the problem.
          format: int32
          nullable: true
        detail:
          type: string
          description: >-
            Human-readable explanation specific to this occurrence of the
            problem.
          nullable: true
        instance:
          type: string
          description: >-
            URI reference that identifies this specific occurrence of the
            problem.
          nullable: true
    OrderByOption:
      type: object
      properties:
        field:
          type: string
          description: The field to sort by.
        direction:
          enum:
            - asc
            - desc
          type: string
          description: An enumerator for sort direction during querying
          nullable: true
      description: An object for ordering during querying
    ExactMatchFilter:
      type: object
      properties:
        value:
          description: The value that the field must match.
        field:
          type: string
          description: The field to filter by.
      description: A generic object for handling exact match filtering during querying
    RangeFilter:
      type: object
      properties:
        greaterThan:
          description: The exclusive lower bound for the field value.
        greaterThanOrEqual:
          description: The inclusive lower bound for the field value.
        lessThan:
          description: The exclusive upper bound for the field value.
        lessThanOrEqual:
          description: The inclusive upper bound for the field value.
        field:
          type: string
          description: The field to filter by.
      description: A generic object for handling range filtering during querying
    EventTableRow:
      type: object
      properties:
        id:
          type: string
          description: Unique Leadping identifier for this event timeline table row.
        eventType:
          type: string
          description: >-
            Event type used to classify this timeline, SMS, call, or automation
            event.
        eventCategory:
          type: string
          description: High-level category used to group this Leadping event.
          nullable: true
        timelineType:
          allOf:
            - $ref: '#/components/schemas/EventTimelineType'
          description: Timeline type used to render this event in Leadping activity feeds.
        timelineCategory:
          type: string
          description: Timeline category used to group events for display and filtering.
        description:
          type: string
          description: >-
            Human-readable description that explains this event timeline table
            row to API users.
        conversationId:
          type: string
          description: >-
            Conversation ID that links this event timeline table row to the
            Leadping inbox thread.
          nullable: true
        leadId:
          type: string
          description: Lead ID associated with this timeline event.
          nullable: true
        relatedEntityType:
          type: string
          description: Related entity type connected to this event or notification.
          nullable: true
        relatedEntityId:
          type: string
          description: Related entity ID connected to this event or notification.
          nullable: true
        summary:
          type: string
          description: >-
            Short human-readable summary of this event timeline table row for
            lists, timelines, and notifications.
          nullable: true
        direction:
          type: string
          description: >-
            Communication direction for this event timeline table row, such as
            inbound or outbound.
          nullable: true
        status:
          enum:
            - Pending
            - InProgress
            - Completed
            - Cancelled
            - Scheduled
            - Queued
            - Sending
            - Sent
            - Received
            - Delivered
            - Undeliverable
            - Opted out
            - Blocked
            - Initiated
            - Ringing
            - Active
            - Ended
            - Missed
            - Voicemail
            - Failed
            - Canceled
          type: string
          description: Defines the supported Event timeline status values.
          nullable: true
        statusReason:
          type: string
          description: >-
            Human-readable reason explaining the current status of this event
            timeline table row.
          nullable: true
        trafficType:
          enum:
            - RealLead
            - Warmup
            - Test
            - SystemInternal
            - FailedAttempt
          type: string
          description: Defines the supported SMS Traffic Type values.
          nullable: true
        fromPhoneNumberId:
          type: string
          description: Sender phone number ID used for this outbound SMS or call.
          nullable: true
        outboundPhoneNumberId:
          type: string
          description: Phone number ID selected for outbound delivery.
          nullable: true
        fromPhoneNumber:
          type: string
          description: Sender phone number used for this communication.
          nullable: true
        toPhoneNumber:
          type: string
          description: Recipient phone number used for this communication.
          nullable: true
        selectionReason:
          enum:
            - StickyConversation
            - LeadAssigned
            - CampaignOrSource
            - Preferred
            - LocalArea
            - HealthyPool
            - FallbackDefault
            - ManualOverride
          type: string
          description: Defines the supported Outgoing Number Selection Reason values.
          nullable: true
        wasManuallyOverridden:
          type: boolean
          description: >-
            Indicates whether a user manually overrode Leadping's automatic
            number selection for this event timeline table row.
        campaignId:
          type: string
          description: >-
            Messaging campaign identifier associated with this event timeline
            table row.
          nullable: true
        sourceId:
          type: string
          description: Lead source ID used for event attribution.
          nullable: true
        complianceAction:
          type: string
          description: Compliance action applied to this message, lead, or sender.
          nullable: true
        billingStatus:
          type: string
          description: Billing state for this communication, charge, or transaction.
          nullable: true
        billableAmount:
          pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$
          description: >-
            Monetary amount billed for this Leadping communication or
            transaction.
          format: double
          nullable: true
        errorCode:
          type: string
          description: >-
            Machine-readable error code returned while processing this event
            timeline table row.
          nullable: true
        retryCount:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: >-
            Number of retry attempts already made for this event timeline table
            row.
          format: int32
        queuedAt:
          type: string
          description: >-
            UTC timestamp when Leadping queued this event timeline table row for
            processing.
          format: date-time
          nullable: true
        sendingStartedAt:
          type: string
          description: UTC timestamp when Leadping began sending this message.
          format: date-time
          nullable: true
        sentAt:
          type: string
          description: UTC timestamp when Leadping sent this message to the provider.
          format: date-time
          nullable: true
        deliveredAt:
          type: string
          description: UTC timestamp when the provider confirmed delivery.
          format: date-time
          nullable: true
        receivedAt:
          type: string
          description: UTC timestamp when Leadping received this inbound event or message.
          format: date-time
          nullable: true
        failedAt:
          type: string
          description: >-
            UTC timestamp when processing failed for this event timeline table
            row.
          format: date-time
          nullable: true
        undeliverableAt:
          type: string
          description: UTC timestamp when the provider marked the message undeliverable.
          format: date-time
          nullable: true
        blockedAt:
          type: string
          description: UTC timestamp when Leadping blocked this communication.
          format: date-time
          nullable: true
        nextRetryAt:
          type: string
          description: >-
            UTC timestamp when Leadping will retry this event timeline table
            row.
          format: date-time
          nullable: true
        scheduledFor:
          type: string
          description: >-
            UTC timestamp when the related delivery or workflow action is
            scheduled to run.
          format: date-time
          nullable: true
        scheduledReason:
          type: string
          description: Reason Leadping scheduled this delivery for a later time.
          nullable: true
        canceledAt:
          type: string
          description: UTC timestamp when this delivery or workflow was canceled.
          format: date-time
          nullable: true
        cancelReason:
          type: string
          description: Reason this delivery, run, or request was canceled.
          nullable: true
        createdAt:
          type: string
          description: UTC timestamp when this event timeline table row was created.
          format: date-time
        createdBy:
          type: string
          description: >-
            Display name or identifier for the person or system that created
            this event timeline table row.
        actorUserId:
          type: string
          description: >-
            User ID for the person or system that created this event timeline
            table row.
          nullable: true
        actorDisplayName:
          type: string
          description: >-
            Display name for the person or system that created this event
            timeline table row.
          nullable: true
        actorEmail:
          type: string
          description: >-
            Email address for the person who created this event timeline table
            row.
          nullable: true
      description: >-
        List item schema for Leadping API event timeline table row results shown
        in searchable tables.
    EventTimelineType:
      enum:
        - Message
        - Sms
        - Mms
        - Call
        - Voicemail
        - Note
        - Disposition
        - LeadCreated
        - LeadUpdated
        - Notification
        - Payment
        - Warmup
      type: string
      description: Defines the supported Event timeline type values.

````