List a conversation's event history
curl --request POST \
--url https://api.leadping.ai/events/conversations/{conversationId} \
--header 'Content-Type: application/json' \
--data '
{
"pageSize": 123,
"continuationToken": "<string>",
"orderBy": [
{
"field": "<string>"
}
],
"includeCount": true,
"search": "<string>",
"searchFields": [
"<string>"
],
"filters": [
{
"value": "<unknown>",
"field": "<string>"
}
],
"rangeFilters": [
{
"greaterThan": "<unknown>",
"greaterThanOrEqual": "<unknown>",
"lessThan": "<unknown>",
"lessThanOrEqual": "<unknown>",
"field": "<string>"
}
]
}
'import requests
url = "https://api.leadping.ai/events/conversations/{conversationId}"
payload = {
"pageSize": 123,
"continuationToken": "<string>",
"orderBy": [{ "field": "<string>" }],
"includeCount": True,
"search": "<string>",
"searchFields": ["<string>"],
"filters": [
{
"value": "<unknown>",
"field": "<string>"
}
],
"rangeFilters": [
{
"greaterThan": "<unknown>",
"greaterThanOrEqual": "<unknown>",
"lessThan": "<unknown>",
"lessThanOrEqual": "<unknown>",
"field": "<string>"
}
]
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)using RestSharp;
var options = new RestClientOptions("https://api.leadping.ai/events/conversations/{conversationId}");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddJsonBody("{\n \"pageSize\": 123,\n \"continuationToken\": \"<string>\",\n \"orderBy\": [\n {\n \"field\": \"<string>\"\n }\n ],\n \"includeCount\": true,\n \"search\": \"<string>\",\n \"searchFields\": [\n \"<string>\"\n ],\n \"filters\": [\n {\n \"value\": \"<unknown>\",\n \"field\": \"<string>\"\n }\n ],\n \"rangeFilters\": [\n {\n \"greaterThan\": \"<unknown>\",\n \"greaterThanOrEqual\": \"<unknown>\",\n \"lessThan\": \"<unknown>\",\n \"lessThanOrEqual\": \"<unknown>\",\n \"field\": \"<string>\"\n }\n ]\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
HttpResponse<String> response = Unirest.post("https://api.leadping.ai/events/conversations/{conversationId}")
.header("Content-Type", "application/json")
.body("{\n \"pageSize\": 123,\n \"continuationToken\": \"<string>\",\n \"orderBy\": [\n {\n \"field\": \"<string>\"\n }\n ],\n \"includeCount\": true,\n \"search\": \"<string>\",\n \"searchFields\": [\n \"<string>\"\n ],\n \"filters\": [\n {\n \"value\": \"<unknown>\",\n \"field\": \"<string>\"\n }\n ],\n \"rangeFilters\": [\n {\n \"greaterThan\": \"<unknown>\",\n \"greaterThanOrEqual\": \"<unknown>\",\n \"lessThan\": \"<unknown>\",\n \"lessThanOrEqual\": \"<unknown>\",\n \"field\": \"<string>\"\n }\n ]\n}")
.asString();const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
pageSize: 123,
continuationToken: '<string>',
orderBy: [{field: '<string>'}],
includeCount: true,
search: '<string>',
searchFields: ['<string>'],
filters: [{value: '<unknown>', field: '<string>'}],
rangeFilters: [
{
greaterThan: '<unknown>',
greaterThanOrEqual: '<unknown>',
lessThan: '<unknown>',
lessThanOrEqual: '<unknown>',
field: '<string>'
}
]
})
};
fetch('https://api.leadping.ai/events/conversations/{conversationId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.leadping.ai/events/conversations/{conversationId}"
payload := strings.NewReader("{\n \"pageSize\": 123,\n \"continuationToken\": \"<string>\",\n \"orderBy\": [\n {\n \"field\": \"<string>\"\n }\n ],\n \"includeCount\": true,\n \"search\": \"<string>\",\n \"searchFields\": [\n \"<string>\"\n ],\n \"filters\": [\n {\n \"value\": \"<unknown>\",\n \"field\": \"<string>\"\n }\n ],\n \"rangeFilters\": [\n {\n \"greaterThan\": \"<unknown>\",\n \"greaterThanOrEqual\": \"<unknown>\",\n \"lessThan\": \"<unknown>\",\n \"lessThanOrEqual\": \"<unknown>\",\n \"field\": \"<string>\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.leadping.ai/events/conversations/{conversationId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'pageSize' => 123,
'continuationToken' => '<string>',
'orderBy' => [
[
'field' => '<string>'
]
],
'includeCount' => true,
'search' => '<string>',
'searchFields' => [
'<string>'
],
'filters' => [
[
'value' => '<unknown>',
'field' => '<string>'
]
],
'rangeFilters' => [
[
'greaterThan' => '<unknown>',
'greaterThanOrEqual' => '<unknown>',
'lessThan' => '<unknown>',
'lessThanOrEqual' => '<unknown>',
'field' => '<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"items": [
{
"id": "<string>",
"eventType": "<string>",
"eventCategory": "<string>",
"timelineCategory": "<string>",
"description": "<string>",
"conversationId": "<string>",
"leadId": "<string>",
"relatedEntityType": "<string>",
"relatedEntityId": "<string>",
"summary": "<string>",
"media": [
{
"url": "<string>",
"contentType": "<string>",
"size": 123,
"sha256": "<string>",
"fileName": "<string>"
}
],
"direction": "<string>",
"statusReason": "<string>",
"fromPhoneNumberId": "<string>",
"outboundPhoneNumberId": "<string>",
"fromPhoneNumber": "<string>",
"toPhoneNumber": "<string>",
"wasManuallyOverridden": true,
"campaignId": "<string>",
"sourceId": "<string>",
"complianceAction": "<string>",
"billingStatus": "<string>",
"billableAmount": 123,
"errorCode": "<string>",
"retryCount": 123,
"queuedAt": "2023-11-07T05:31:56Z",
"sendingStartedAt": "2023-11-07T05:31:56Z",
"sentAt": "2023-11-07T05:31:56Z",
"deliveredAt": "2023-11-07T05:31:56Z",
"receivedAt": "2023-11-07T05:31:56Z",
"failedAt": "2023-11-07T05:31:56Z",
"undeliverableAt": "2023-11-07T05:31:56Z",
"blockedAt": "2023-11-07T05:31:56Z",
"nextRetryAt": "2023-11-07T05:31:56Z",
"scheduledFor": "2023-11-07T05:31:56Z",
"scheduledReason": "<string>",
"canceledAt": "2023-11-07T05:31:56Z",
"cancelReason": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"createdBy": "<string>",
"actorUserId": "<string>",
"actorDisplayName": "<string>",
"actorEmail": "<string>"
}
],
"pageSize": 123,
"totalCount": 123,
"continuationToken": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}Events
List a conversation's event history
Lists event records for one conversation with paging, including notes, messages, calls, and follow-up history.
POST
/
events
/
conversations
/
{conversationId}
List a conversation's event history
curl --request POST \
--url https://api.leadping.ai/events/conversations/{conversationId} \
--header 'Content-Type: application/json' \
--data '
{
"pageSize": 123,
"continuationToken": "<string>",
"orderBy": [
{
"field": "<string>"
}
],
"includeCount": true,
"search": "<string>",
"searchFields": [
"<string>"
],
"filters": [
{
"value": "<unknown>",
"field": "<string>"
}
],
"rangeFilters": [
{
"greaterThan": "<unknown>",
"greaterThanOrEqual": "<unknown>",
"lessThan": "<unknown>",
"lessThanOrEqual": "<unknown>",
"field": "<string>"
}
]
}
'import requests
url = "https://api.leadping.ai/events/conversations/{conversationId}"
payload = {
"pageSize": 123,
"continuationToken": "<string>",
"orderBy": [{ "field": "<string>" }],
"includeCount": True,
"search": "<string>",
"searchFields": ["<string>"],
"filters": [
{
"value": "<unknown>",
"field": "<string>"
}
],
"rangeFilters": [
{
"greaterThan": "<unknown>",
"greaterThanOrEqual": "<unknown>",
"lessThan": "<unknown>",
"lessThanOrEqual": "<unknown>",
"field": "<string>"
}
]
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)using RestSharp;
var options = new RestClientOptions("https://api.leadping.ai/events/conversations/{conversationId}");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddJsonBody("{\n \"pageSize\": 123,\n \"continuationToken\": \"<string>\",\n \"orderBy\": [\n {\n \"field\": \"<string>\"\n }\n ],\n \"includeCount\": true,\n \"search\": \"<string>\",\n \"searchFields\": [\n \"<string>\"\n ],\n \"filters\": [\n {\n \"value\": \"<unknown>\",\n \"field\": \"<string>\"\n }\n ],\n \"rangeFilters\": [\n {\n \"greaterThan\": \"<unknown>\",\n \"greaterThanOrEqual\": \"<unknown>\",\n \"lessThan\": \"<unknown>\",\n \"lessThanOrEqual\": \"<unknown>\",\n \"field\": \"<string>\"\n }\n ]\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
HttpResponse<String> response = Unirest.post("https://api.leadping.ai/events/conversations/{conversationId}")
.header("Content-Type", "application/json")
.body("{\n \"pageSize\": 123,\n \"continuationToken\": \"<string>\",\n \"orderBy\": [\n {\n \"field\": \"<string>\"\n }\n ],\n \"includeCount\": true,\n \"search\": \"<string>\",\n \"searchFields\": [\n \"<string>\"\n ],\n \"filters\": [\n {\n \"value\": \"<unknown>\",\n \"field\": \"<string>\"\n }\n ],\n \"rangeFilters\": [\n {\n \"greaterThan\": \"<unknown>\",\n \"greaterThanOrEqual\": \"<unknown>\",\n \"lessThan\": \"<unknown>\",\n \"lessThanOrEqual\": \"<unknown>\",\n \"field\": \"<string>\"\n }\n ]\n}")
.asString();const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
pageSize: 123,
continuationToken: '<string>',
orderBy: [{field: '<string>'}],
includeCount: true,
search: '<string>',
searchFields: ['<string>'],
filters: [{value: '<unknown>', field: '<string>'}],
rangeFilters: [
{
greaterThan: '<unknown>',
greaterThanOrEqual: '<unknown>',
lessThan: '<unknown>',
lessThanOrEqual: '<unknown>',
field: '<string>'
}
]
})
};
fetch('https://api.leadping.ai/events/conversations/{conversationId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.leadping.ai/events/conversations/{conversationId}"
payload := strings.NewReader("{\n \"pageSize\": 123,\n \"continuationToken\": \"<string>\",\n \"orderBy\": [\n {\n \"field\": \"<string>\"\n }\n ],\n \"includeCount\": true,\n \"search\": \"<string>\",\n \"searchFields\": [\n \"<string>\"\n ],\n \"filters\": [\n {\n \"value\": \"<unknown>\",\n \"field\": \"<string>\"\n }\n ],\n \"rangeFilters\": [\n {\n \"greaterThan\": \"<unknown>\",\n \"greaterThanOrEqual\": \"<unknown>\",\n \"lessThan\": \"<unknown>\",\n \"lessThanOrEqual\": \"<unknown>\",\n \"field\": \"<string>\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.leadping.ai/events/conversations/{conversationId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'pageSize' => 123,
'continuationToken' => '<string>',
'orderBy' => [
[
'field' => '<string>'
]
],
'includeCount' => true,
'search' => '<string>',
'searchFields' => [
'<string>'
],
'filters' => [
[
'value' => '<unknown>',
'field' => '<string>'
]
],
'rangeFilters' => [
[
'greaterThan' => '<unknown>',
'greaterThanOrEqual' => '<unknown>',
'lessThan' => '<unknown>',
'lessThanOrEqual' => '<unknown>',
'field' => '<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"items": [
{
"id": "<string>",
"eventType": "<string>",
"eventCategory": "<string>",
"timelineCategory": "<string>",
"description": "<string>",
"conversationId": "<string>",
"leadId": "<string>",
"relatedEntityType": "<string>",
"relatedEntityId": "<string>",
"summary": "<string>",
"media": [
{
"url": "<string>",
"contentType": "<string>",
"size": 123,
"sha256": "<string>",
"fileName": "<string>"
}
],
"direction": "<string>",
"statusReason": "<string>",
"fromPhoneNumberId": "<string>",
"outboundPhoneNumberId": "<string>",
"fromPhoneNumber": "<string>",
"toPhoneNumber": "<string>",
"wasManuallyOverridden": true,
"campaignId": "<string>",
"sourceId": "<string>",
"complianceAction": "<string>",
"billingStatus": "<string>",
"billableAmount": 123,
"errorCode": "<string>",
"retryCount": 123,
"queuedAt": "2023-11-07T05:31:56Z",
"sendingStartedAt": "2023-11-07T05:31:56Z",
"sentAt": "2023-11-07T05:31:56Z",
"deliveredAt": "2023-11-07T05:31:56Z",
"receivedAt": "2023-11-07T05:31:56Z",
"failedAt": "2023-11-07T05:31:56Z",
"undeliverableAt": "2023-11-07T05:31:56Z",
"blockedAt": "2023-11-07T05:31:56Z",
"nextRetryAt": "2023-11-07T05:31:56Z",
"scheduledFor": "2023-11-07T05:31:56Z",
"scheduledReason": "<string>",
"canceledAt": "2023-11-07T05:31:56Z",
"cancelReason": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"createdBy": "<string>",
"actorUserId": "<string>",
"actorDisplayName": "<string>",
"actorEmail": "<string>"
}
],
"pageSize": 123,
"totalCount": 123,
"continuationToken": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}Path Parameters
The ID of the conversation.
Body
application/jsonapplication/*+json
Pagination, filtering, and sorting options.
Options for flexible, efficient, and explicit querying in Cosmos DB or similar repositories.
Maximum items to return in one page
Opaque Cosmos DB continuation token. ‑ on the first request. ‑ Client must echo back the NextToken it received from the previous page.
List of sort instructions, in priority order.
Show child attributes
Show child attributes
Whether to include the total count in the response (for pagination).
The search term to filter results (applied to ).
The list of fields to apply the Search term to (must be string properties).
Key-value exact match filters (e.g., Status = Active).
Show child attributes
Show child attributes
Advanced range-based filters (e.g., Price > 50 and Price <= 200).
Show child attributes
Show child attributes
Response
Events for the conversation were successfully retrieved.
A generic container for paginated results returned to the client.
The subset of items returned for the current page.
Show child attributes
Show child attributes
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.
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).
Opaque storage continuation token. ‑ null → the current page was the last page.
Last modified on August 11, 2026
⌘I