> ## 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 user's inbox conversations > Lists the current user's lead conversations with paging and sorting for inbox views, recent follow-up, and communication history. ## OpenAPI ````yaml /openapi.json post /conversations/my 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: /conversations/my: post: tags: - Conversations summary: List current user's inbox conversations description: >- Lists the current user's lead conversations with paging and sorting for inbox views, recent follow-up, and communication history. operationId: Conversations_GetAllForCurrentUser parameters: - name: archiveFilter in: query schema: type: string requestBody: description: Cancellation token. content: application/json: schema: allOf: - $ref: '#/components/schemas/RequestDataOptions' description: >- Options for flexible, efficient, and explicit querying in Cosmos DB or similar repositories. text/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: Returns the paged conversation response. content: text/plain: schema: allOf: - $ref: '#/components/schemas/PagedResultOfConversationResponse' description: >- A generic container for paginated results returned to the client. application/json: schema: allOf: - $ref: '#/components/schemas/PagedResultOfConversationResponse' description: >- A generic container for paginated results returned to the client. text/json: schema: allOf: - $ref: '#/components/schemas/PagedResultOfConversationResponse' description: >- A generic container for paginated results returned to the client. '400': description: The request was invalid or failed validation. content: text/plain: schema: $ref: '#/components/schemas/ProblemDetails' application/json: schema: $ref: '#/components/schemas/ProblemDetails' text/json: schema: $ref: '#/components/schemas/ProblemDetails' '401': description: Unauthorized content: text/plain: schema: $ref: '#/components/schemas/ProblemDetails' application/json: schema: $ref: '#/components/schemas/ProblemDetails' text/json: schema: $ref: '#/components/schemas/ProblemDetails' '500': description: An unexpected server error occurred. content: text/plain: schema: $ref: '#/components/schemas/ProblemDetails' application/json: schema: $ref: '#/components/schemas/ProblemDetails' text/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. PagedResultOfConversationResponse: type: object properties: items: type: array items: allOf: - $ref: '#/components/schemas/ConversationResponse' description: >- Response schema for the Leadping API conversation response returned to authenticated clients. 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 ConversationResponse: type: object properties: id: type: string description: Unique Leadping identifier for this conversation response. leadId: type: string description: Lead ID associated with this inbox conversation. firstName: type: string description: >- First name of the lead, user, or contact represented by this conversation response. nullable: true lastName: type: string description: >- Last name of the lead, user, or contact represented by this conversation response. nullable: true email: type: string description: Email address used to resolve the lead's avatar when available. nullable: true lastSnippet: type: string description: Most recent message preview shown for the conversation. nullable: true lastEventAt: type: string description: UTC timestamp when the most recent conversation event occurred. format: date-time nullable: true status: enum: - needs_reply - waiting - failed - open type: string description: >- Defines the customer-facing operational status for an inbox conversation. nullable: true statusReason: type: string description: >- Human-readable reason explaining the current status of this conversation response. nullable: true archivedAt: type: string description: UTC timestamp when this record was archived. format: date-time nullable: true archiveReason: enum: - 0 - 1 - 2 - 3 - 4 - 5 - 6 - 7 - 8 - 9 type: integer description: Defines why a lead was removed from the active working pipeline. format: int32 nullable: true isArchived: type: boolean description: Indicates whether the Leadping conversation has been archived. currentDisposition: type: object allOf: - $ref: '#/components/schemas/CurrentDispositionSummary' description: Current disposition summary that describes the lead outcome. nullable: true nextStep: type: string description: Recommended next step to move this conversation response forward. nullable: true isUnread: type: boolean description: >- Indicates whether the current user has unread activity in the conversation. phoneNumber: type: object allOf: - $ref: '#/components/schemas/IdNameValue' description: >- Phone number used by this conversation response for calls, SMS, lookup, or routing. nullable: true leadPhoneNumber: type: string description: Lead's phone number used for conversation matching and outreach. nullable: true outboundPhoneNumberOverrideId: type: string description: >- Phone number ID manually chosen to override automatic outbound selection. nullable: true activeOutboundPhoneNumberId: type: string description: Phone number ID currently active for outbound delivery. nullable: true description: >- Response schema for the Leadping API conversation response returned to authenticated clients. CurrentDispositionSummary: type: object properties: id: type: string description: Unique Leadping identifier for this current disposition summary. nullable: true category: enum: - Open - Qualified - Converted - Lost - Invalid - Duplicate type: string description: >- Controlled disposition categories used for reporting, automation, and analytics. nullable: true outcome: type: string description: Current disposition outcome assigned to the lead. nullable: true displayName: type: string description: >- Human-readable display name shown for this current disposition summary. changedAt: type: string description: UTC timestamp when the disposition last changed. format: date-time nullable: true changedByUserId: type: string description: User ID of the person who last changed the disposition. nullable: true changedByAutomationId: type: string description: Automation ID that last changed the disposition. nullable: true source: enum: - User - AI - Automation - System - API type: string description: Known sources that can change a lead's current disposition. nullable: true description: >- Summary schema for Leadping API current disposition summary data used in dashboards and reports. IdNameValue: required: - id - name type: object properties: value: type: string description: The optional value associated with the identifier and name. nullable: true id: type: string description: The unique identifier. name: type: string description: The display name. description: >- A minimal Record type with an Id (string), Name (string), nullable Value (string?) and maximum JSON compatibility ````