---
title: "Search Calls"
method: POST
path: "/v1/Outbound/{outboundId}/Calls"
tags: ["Outbound"]
---

# Search Calls

`POST /v1/Outbound/{outboundId}/Calls`

Retrieves the calls within a specific date range for a given outbound

## Path parameters

- `outboundId` string, required

## Request body

- CallsTableDateSearchApi
  - `skip` integer — Number of entries to skip for pagination.
  - `limit` integer — Limit on the number of entries to return.
  - `sortProp` string, nullable — Property name to sort by.
  - `isAscending` boolean — Whether the sort order is ascending.
  - `fromDate` string, date-time, required — The start date for filtering the search results.
  - `toDate` string, date-time, required — The end date for filtering the search results.
  - `tags` string[], nullable — List of tags to filter by.
  - `statuses` EConversationStatusView[], nullable — List of Status to filter by.
  - `searchInput` string, nullable — Text to filter by.

## Response `200`

Calls within the specified date range for the outbound.

- CallListApiViewTableSearchResult
  - `count` integer — The total number of items matching the search criteria.
  - `results` CallListApiView[], nullable — The list of results for the current page, based on the search criteria.
    - `id` string, nullable — The unique identifier of the call.
    - `startTime` string, date-time, nullable — The date and time when the call processing started.
    - `conversationStatus` integer — The outcome of the conversation during the call. To determine the definition of 'Success' or 'Not Successful,' please refer to the [Create a Pearl](/pages/create_pearl#pearl-name) page at step 4. `10 - NotAnswered` `40 - OnGoing` `70 - VoiceMailLeft` `100 - Success` `110 - NotSuccessful` `130 - Completed` `150 - Unreachable` `220 - Blacklisted` `300 - QueueAbandon` `500 - Error`
    - `status` integer — Represents the current status of a call. `3 - InProgress` `4 - Completed` `5 - Busy` `6 - Failed` `7 - NoAnswer` `8 - Canceled` `10 - OnGoingText`
    - `from` string, nullable — The phone number from which the call was made.
    - `to` string, nullable — The phone number to which the call was made.
    - `duration` integer — The duration of the call in seconds.
    - `tags` string[], nullable — The tags or labels triggered during the conversation

## Other responses

- `400` — Error

---

[API](https://skmtc.net/nlpearl/apis/nlpearl-client-api.md) · [All operations](https://skmtc.net/nlpearl/apis/nlpearl-client-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nlpearl/nlpearl-client-api/versions/52d64fc5d6e9/schema)