---
title: "Search by Agent"
method: POST
path: "/v1.0/agent/communication"
tags: ["Communication"]
---

# Search by Agent

`POST /v1.0/agent/communication`

Returns a page of communication timeline entries for the caller (or the caller's team when teamView=true, requiring ACCESS_ALL_TEAM_LEADS permission), filtered by type and optional time range. The response is a page wrapper with totalCount, offset, limit, and pageData.

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Request body

- CommunicationRequest — Communication search request payload.
  - `type` 'CALL' | 'TEXT' | 'EMAIL' | 'ALL', required — CALL, EMAIL OR TEXT
  - `startTime` integer, required — startTimestamp
  - `endTime` integer, required — endTimestamp (The maximum time interval for a single query is 24 hours)
  - `offset` integer — offset default Value 0
  - `limit` integer — limit default Value 10,max value 1000
  - `teamView` boolean — search team lead's communication, default false

## Response `200`

Page of communication entries.

- PageResult
  - `offset` integer — current offset
  - `limit` integer — limit
  - `pageData` object[] — page data
  - `hasMore` boolean — has more

## Other responses

- `400` — Invalid parameters, or teamView=true without ACCESS_ALL_TEAM_LEADS permission.
- `401` — Missing or invalid authentication token.
- `500` — Internal server error.

---

[API](https://skmtc.net/lofty/apis/lofty-service-open-apis.md) · [All operations](https://skmtc.net/lofty/apis/lofty-service-open-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lofty/lofty-service-open-apis/revisions/23e640467118/schema)