> ## 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 call event history for a business lead > Lists call events for one lead with paging, helping users review call attempts, outcomes, and follow-up history. ## OpenAPI ````yaml /openapi.json post /events/calls/lead/{leadId} 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/calls/lead/{leadId}: post: tags: - CallEvents summary: List call event history for a business lead description: >- Lists call events for one lead with paging, helping users review call attempts, outcomes, and follow-up history. operationId: CallEvents_GetByLeadId parameters: - name: leadId in: path description: The ID of the lead. 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: Returns the paged call event table row. content: application/json: schema: allOf: - $ref: '#/components/schemas/PagedResultOfCallEventTableRow' description: >- A generic container for paginated results returned to the client. '400': description: The request was invalid or failed validation. 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. PagedResultOfCallEventTableRow: type: object properties: items: type: array items: allOf: - $ref: '#/components/schemas/CallEventTableRow' description: >- List item schema for Leadping API call event 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 CallEventTableRow: type: object properties: id: type: string description: Unique Leadping identifier for this call event table row. leadId: type: string description: Lead ID associated with this call event. nullable: true businessId: type: string description: Business ID associated with this call event. nullable: true userId: type: string description: >- User ID associated with the person or agent who initiated this call event. nullable: true conversationId: type: string description: >- Conversation ID that links this call event table row to the Leadping inbox thread. nullable: true fromPhoneNumberId: type: string description: Sender phone number ID used for this outbound SMS or call. nullable: true fromPhoneNumber: type: string description: Sender phone number used for this communication. toPhoneNumber: type: string description: Recipient phone number used for this communication. callerId: type: string description: Caller ID phone number presented during the outbound call. nullable: true status: enum: - scheduled - queued - initiated - ringing - in_progress - active - completed - ended - busy - no_answer - failed - canceled - missed - transferred - voicemail - blocked_billing - blocked_phone_number_status - blocked_configuration - blocked_permission - configuration_required type: string description: Defines the supported Phone Call Status values. nullable: true statusReason: type: string description: >- Human-readable reason explaining the current status of this call event table row. nullable: true direction: type: string description: >- Communication direction for this call event table row, such as inbound or outbound. createdAt: type: string description: UTC timestamp when this call event table row was created. format: date-time answeredAt: type: string description: UTC timestamp when the call was answered. format: date-time nullable: true endedAt: type: string description: UTC timestamp when the call ended. format: date-time nullable: true duration: pattern: ^-?(?:0|[1-9]\d*)$ description: >- Call duration or processing duration represented by this call event table row. format: int32 nullable: true billableSeconds: pattern: ^-?(?:0|[1-9]\d*)$ description: Billable call duration in seconds. format: int32 nullable: true billableAmount: pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$ description: >- Monetary amount billed for this Leadping communication or transaction. format: double nullable: true billingStatus: type: string description: Billing state for this communication, charge, or transaction. nullable: true recordingUrl: type: string description: URL for the call recording, when the provider makes one available. nullable: true user: type: string description: User summary connected to this call event table row. business: type: string description: Business summary connected to this call event table row. description: >- List item schema for Leadping API call event table row results shown in searchable tables. ````