> ## 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 current-organization lead status history

> Returns a filtered, paginated history of lead status changes for the current organization for workflow analysis, reporting, and audit review.



## OpenAPI

````yaml /openapi.json post /lead-status-changes/all/my
openapi: 3.1.1
info:
  title: Leadping API
  description: >-
    Leadping API for lead intake, messaging, calling, automations, billing,
    organization 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: Feedback
  - name: Leads
  - name: LeadStatusChanges
  - name: LeadStatuses
  - name: Notifications
  - name: OutboundDelivery
  - name: Sources
  - name: Suppressions
  - name: Tags
  - name: Users
  - name: Calls
  - name: PhoneNumbers
  - name: Sms
  - name: Telephony
  - name: Organizations
  - name: UserDataExports
  - name: CallEvents
  - name: Events
  - name: SmsEvents
  - name: PaymentMethods
  - name: Transactions
  - name: Usage
  - name: Wallets
paths:
  /lead-status-changes/all/my:
    post:
      tags:
        - LeadStatusChanges
      summary: List current-organization lead status history
      description: >-
        Returns a filtered, paginated history of lead status changes for the
        current organization for workflow analysis, reporting, and audit review.
      operationId: LeadStatusChanges_GetAllForCurrentOrganization
      requestBody:
        description: >-
          Pagination, filtering, and sorting options for the lead status
          history.
        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: OK
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/PagedResultOfLeadStatusChangeResponse'
                description: >-
                  A generic container for paginated results returned to the
                  client.
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ProblemDetails'
                description: >-
                  Standard problem-details response containing machine-readable
                  and human-readable information about an HTTP API error.
components:
  schemas:
    RequestDataOptions:
      type: object
      properties:
        pageSize:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - integer
            - string
          description: Maximum items to return in one page
          format: int32
        continuationToken:
          type:
            - 'null'
            - string
          description: >-
            Opaque Cosmos DB continuation token. ‑ on the **first** request. ‑
            Client must echo back the NextToken it received from the previous
            page.
        orderBy:
          type:
            - 'null'
            - array
          items:
            allOf:
              - $ref: '#/components/schemas/OrderByOption'
            description: An object for ordering during querying
          description: List of sort instructions, in priority order.
        includeCount:
          type:
            - 'null'
            - boolean
          description: Whether to include the total count in the response (for pagination).
        search:
          type:
            - 'null'
            - string
          description: The search term to filter results (applied to ).
        searchFields:
          type:
            - 'null'
            - array
          items:
            type: string
          description: >-
            The list of fields to apply the Search term to (must be string
            properties).
        filters:
          type:
            - 'null'
            - 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).
        rangeFilters:
          type:
            - 'null'
            - 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).
      description: >-
        Options for flexible, efficient, and explicit querying in Cosmos DB or
        similar repositories.
    PagedResultOfLeadStatusChangeResponse:
      type: object
      properties:
        items:
          type: array
          items:
            allOf:
              - $ref: '#/components/schemas/LeadStatusChangeResponse'
            description: Response model for lead status change data.
          description: The subset of items returned for the current page.
        pageSize:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - integer
            - string
          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*)$
          type:
            - 'null'
            - integer
            - string
          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
        continuationToken:
          type:
            - 'null'
            - string
          description: >-
            Opaque storage continuation token. ‑ `null` → the current page was
            the last page.
      description: A generic container for paginated results returned to the client.
    ProblemDetails:
      type: object
      properties:
        type:
          type:
            - 'null'
            - string
          description: URI reference that identifies the problem type.
        title:
          type:
            - 'null'
            - string
          description: Short, human-readable summary of the problem.
        status:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - 'null'
            - integer
            - string
          description: HTTP status code returned for the problem.
          format: int32
        detail:
          type:
            - 'null'
            - string
          description: >-
            Human-readable explanation specific to this occurrence of the
            problem.
        instance:
          type:
            - 'null'
            - string
          description: >-
            URI reference that identifies this specific occurrence of the
            problem.
      description: >-
        Standard problem-details response containing machine-readable and
        human-readable information about an HTTP API error.
    OrderByOption:
      type: object
      properties:
        field:
          type: string
          description: The field to sort by.
        direction:
          enum:
            - asc
            - desc
          type:
            - 'null'
            - string
          description: An enumerator for sort direction during querying
      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
    LeadStatusChangeResponse:
      type: object
      properties:
        id:
          type: string
          description: Unique Leadping identifier for this lead status change.
        leadId:
          type: string
          description: The lead ID associated with this lead status change.
        leadName:
          type:
            - 'null'
            - string
          description: >-
            The display name of the lead associated with this lead status
            change.
        type:
          type: string
          description: Category of status change recorded for the lead.
        outcome:
          type: string
          description: >-
            Result of the interaction or workflow step that caused the status
            change.
        category:
          enum:
            - Open
            - Qualified
            - Converted
            - Lost
            - Invalid
            - Duplicate
          type:
            - 'null'
            - string
          description: >-
            Controlled lead status change categories used for reporting,
            automation, and analytics.
        oldLeadStatusChangeId:
          type:
            - 'null'
            - string
          description: >-
            Unique identifier of the old lead status change associated with this
            Leadping lead status change.
        oldLeadStatusChangeType:
          type:
            - 'null'
            - string
          description: >-
            Old lead status change type classification for this Leadping lead
            status change.
        oldLeadStatusChangeOutcome:
          type:
            - 'null'
            - string
          description: >-
            Old lead status change outcome associated with this Leadping lead
            status change.
        newLeadStatusChangeId:
          type:
            - 'null'
            - string
          description: >-
            Unique identifier of the new lead status change associated with this
            Leadping lead status change.
        notes:
          type: string
          description: The operator or customer notes recorded for this lead status change.
        reason:
          type:
            - 'null'
            - string
          description: The reason this lead status change was changed.
        changedByUserId:
          type:
            - 'null'
            - string
          description: Unique identifier of the Leadping user who made the change.
        changedByAutomationId:
          type:
            - 'null'
            - string
          description: >-
            Unique identifier of the automation that changed the lead status
            change, when applicable.
        changedAt:
          type:
            - 'null'
            - string
          description: Date and time when the lead status change change occurred.
          format: date-time
        changeSource:
          enum:
            - User
            - AI
            - Automation
            - System
            - API
          type:
            - 'null'
            - string
          description: Known sources that can change a lead's current lead status change.
        timestamp:
          type: string
          description: UTC timestamp for timestamp on this lead status change.
          format: date-time
        createdAt:
          type: string
          description: UTC timestamp for created at on this lead status change.
          format: date-time
        updatedAt:
          type: string
          description: UTC timestamp for updated at on this lead status change.
          format: date-time
        followUpStatus:
          type:
            - 'null'
            - string
          description: The current follow up status for this lead status change.
        callbackAt:
          type:
            - 'null'
            - string
          description: UTC timestamp for callback at on this lead status change.
          format: date-time
        taskDueAt:
          type:
            - 'null'
            - string
          description: UTC timestamp for task due at on this lead status change.
          format: date-time
        appointmentStartAt:
          type:
            - 'null'
            - string
          description: UTC timestamp for appointment start at on this lead status change.
          format: date-time
        appointmentEndAt:
          type:
            - 'null'
            - string
          description: UTC timestamp for appointment end at on this lead status change.
          format: date-time
        appointmentNotes:
          type:
            - 'null'
            - string
          description: >-
            Additional scheduling or preparation notes for the related
            appointment.
        assignedToUserId:
          type:
            - 'null'
            - string
          description: The assigned to user ID associated with this lead status change.
        relatedCallEventId:
          type:
            - 'null'
            - string
          description: The related call event ID associated with this lead status change.
        isMissedCallFollowUp:
          type: boolean
          description: Whether this lead status change is missed call follow up.
        sourceId:
          type:
            - 'null'
            - string
          description: The source ID associated with this lead status change.
      description: Response model for lead status change data.

````