> ## 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.

# Icypeas: Read Results

> Read the result of an email search, email verification, or domain search by search id, or poll until an async search finishes. Free endpoint.

Read the result of an email search, email verification, or domain search by search id, or poll until an async search finishes.

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

## 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(
  'icypeas_read_results',
  {
    "id": "id_123",
    "mode": "single",
    "file": "example"
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute icypeas_read_results --input '{
  "id": "id_123",
  "mode": "single",
  "file": "example"
}' --json
```

## Example response

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

## Input reference

Retrieve results for single or bulk searches. Free endpoint.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.id` | `string` | No | — | Specific search ID to retrieve results for. |
| `payload.mode` | `"single" \| "bulk"` | No | — | Result mode: single search or bulk file. Allowed: `single`, `bulk`. |
| `payload.file` | `string` | No | — | Bulk file reference ID. |
| `payload.limit` | `integer` | No | — | Number of results to return (1-100). |
| `payload.type` | `"email-search" \| "email-verification" \| "domain-scan"` | No | — | Filter results by search type. Allowed: `email-search`, `email-verification`, `domain-scan`. |
| `payload.next` | `boolean` | No | — | Pagination cursor flag. |
| `payload.sort` | `array` | No | — | Sort configuration. |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Retrieve results for single or bulk searches. Free endpoint.",
    "properties": {
      "id": {
        "type": "string",
        "description": "Specific search ID to retrieve results for."
      },
      "mode": {
        "type": "string",
        "description": "Result mode: single search or bulk file.",
        "enum": [
          "single",
          "bulk"
        ]
      },
      "file": {
        "type": "string",
        "description": "Bulk file reference ID."
      },
      "limit": {
        "type": "integer",
        "description": "Number of results to return (1-100)."
      },
      "type": {
        "type": "string",
        "description": "Filter results by search type.",
        "enum": [
          "email-search",
          "email-verification",
          "domain-scan"
        ]
      },
      "next": {
        "type": "boolean",
        "description": "Pagination cursor flag."
      },
      "sort": {
        "type": "array",
        "description": "Sort configuration.",
        "items": {}
      }
    },
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `record` | Yes | — | Provider response payload. |
| `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": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "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

* [Icypeas provider guide](https://deepline.com/docs/providers/icypeas/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.