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

# Research

> research_contacts, research_companies, and poll tools.

Enrich contacts and companies with verified data. **Consumes credits.** Research is async — use poll tools or set `waitForResults: true` on research calls.

| Tool                    | Description                                                                                                                  | Risk    | Schema                                             |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------- | ------- | -------------------------------------------------- |
| `research_contacts`     | Enrich contacts for verified email and phone. Pass `searchResultIds` or `contacts`. Set `waitForResults: true` to auto-poll. | `write` | [#research\_contacts](#research_contacts)          |
| `poll_contact_research` | Poll contact research with `requestIds` from `research_contacts`.                                                            | `read`  | [#poll\_contact\_research](#poll_contact_research) |
| `research_companies`    | Enrich companies for revenue, size, technologies, etc.                                                                       | `write` | [#research\_companies](#research_companies)        |
| `poll_company_research` | Poll company research with `requestIds` from `research_companies`.                                                           | `read`  | [#poll\_company\_research](#poll_company_research) |

## research\_contacts

<ParamField path="searchResultIds" type="string[]">
  IDs from `search_contacts`.
</ParamField>

<ParamField path="waitForResults" type="boolean">
  When true, blocks until results are ready.
</ParamField>

### Example

```json theme={null}
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "research_contacts",
    "arguments": {
      "searchResultIds": ["abc123"],
      "waitForResults": true
    }
  },
  "id": 1
}
```

## poll\_contact\_research

### Example

```json theme={null}
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "poll_contact_research",
    "arguments": {
      "requestIds": ["req-456"]
    }
  },
  "id": 1
}
```

## research\_companies

### Example

```json theme={null}
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "research_companies",
    "arguments": {
      "searchResultIds": ["co-789"]
    }
  },
  "id": 1
}
```

## poll\_company\_research

### Example

```json theme={null}
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "poll_company_research",
    "arguments": {
      "requestIds": ["req-101"]
    }
  },
  "id": 1
}
```