> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Apollo: Search Calls

> Search the calls logged in Apollo, filtered by contact or user. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

Search the calls logged in Apollo, filtered by contact or user.

> [!NOTE]
>
> Tool ID: `apollo_search_calls`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'apollo_search_calls',
  {
    "contact_id": "contact_123",
    "user_id": "user_123",
    "page": 1
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute apollo_search_calls --input '{
  "contact_id": "contact_123",
  "user_id": "user_123",
  "page": 1
}' --json
```

## Example response

The static output schema lacks the details for a reliable example. Use `deepline describe apollo_search_calls --json` for the complete live contract.

## Input reference

Search for call records in Apollo. Requires master API key.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.contact_id` | `string` | No | — | Filter calls by contact ID. |
| `payload.user_id` | `string` | No | — | Filter calls by user ID. |
| `payload.page` | `integer` | No | `1` | Page number. |
| `payload.per_page` | `integer` | No | `25` | Results per page (max 100). |
| `payload.sort_by` | `string` | No | — | Field to sort results by. |
| `payload.sort_order` | `string` | No | — | Sort order: asc or desc. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Search for call records in Apollo. Requires master API key.",
    "properties": {
      "contact_id": {
        "type": "string",
        "description": "Filter calls by contact ID."
      },
      "user_id": {
        "type": "string",
        "description": "Filter calls by user ID."
      },
      "page": {
        "type": "integer",
        "description": "Page number.",
        "default": 1
      },
      "per_page": {
        "type": "integer",
        "description": "Results per page (max 100).",
        "default": 25
      },
      "sort_by": {
        "type": "string",
        "description": "Field to sort results by."
      },
      "sort_order": {
        "type": "string",
        "description": "Sort order: asc or desc."
      }
    },
    "required": [],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Apollo search calls result.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `record` | Yes | — | Payload with `phone_calls` array and `pagination` metadata. |
| `result.meta` | `record` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Apollo search calls result.",
    "properties": {
      "data": {
        "type": [
          "object",
          "null"
        ],
        "description": "Payload with `phone_calls` array and `pagination` metadata.",
        "additionalProperties": {}
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": {}
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Apollo provider guide](https://deepline.com/docs/providers/apollo/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.