> ## 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, `listIds` to file saved contacts into lists, or `skipDeduplicationCheck: true` to re-enrich an already-researched record. | `write` | [#research\_contacts](#research_contacts) |
| `poll_contact_research` | Poll contact research with `requestIds` from `research_contacts`. Results include `jobHistory` (prior roles, most recent departure first). | `read` | [#poll\_contact\_research](#poll_contact_research) |
| `research_companies` | Enrich companies for revenue, size, technologies, etc. Accepts `skipDeduplicationCheck` to re-enrich an already-researched record. | `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>

<ParamField path="listIds" type="(integer | string)[]">
  Contact lists to add each newly saved contact to. Contacts that were already researched are not saved again and so are not added — use `update_my_contact` for those.
</ParamField>

<ParamField path="skipDeduplicationCheck" type="boolean">
  Re-enrich a record that has already been researched. Consumes credits again.
</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
}
```


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