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

# QuickEnrich: Contact Search

> Find people matching filters like job title, company, location, industry and size, with emails and phones masked. Includes SDK V2 examples, schemas, and cost.

Find people matching filters like job title, company, location, industry and size, with emails and phones masked.

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

## 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(
  'quickenrich_contact_search',
  {
    "page": 1,
    "per_page": 10,
    "has_email": true
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute quickenrich_contact_search --input '{
  "page": 1,
  "per_page": 10,
  "has_email": true
}' --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "success": true,
    "message": "Example message",
    "code": 123
  }
}
```

Use `deepline describe quickenrich_contact_search --json` for the latest machine-readable contract.

## Input reference

Filter-based contact search. Email and phone values are masked (`has_email` / `has_phone`). Use `/reveal` to unlock contact details. At least one filter is required: a non-empty include/exclude dimension, `has_email`, or `has_phone`. Constrained dimensions (`country_code`, `industry_linkedin`, `number_of_employees`, `revenue`, `services`) must use exact values from the Lookups endpoints. Max 50 values per include/exclude list.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.page` | `integer` | No | `1` | Minimum: 1. |
| `payload.per_page` | `integer` | No | `10` | Minimum: 1. Maximum: 100. |
| `payload.has_email` | `boolean` | No | — | — |
| `payload.has_phone` | `boolean` | No | — | — |
| `payload.company_name` | `object` | No | — | — |
| `payload.company_url` | `object` | No | — | — |
| `payload.city` | `object` | No | — | — |
| `payload.country_code` | `object` | No | — | — |
| `payload.industry_linkedin` | `object` | No | — | — |
| `payload.number_of_employees` | `object` | No | — | — |
| `payload.revenue` | `object` | No | — | — |
| `payload.title` | `object` | No | — | — |
| `payload.locality` | `object` | No | — | — |
| `payload.bio_li` | `object` | No | — | — |
| `payload.services` | `object` | No | — | — |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Filter-based contact search. Email and phone values are masked (`has_email` / `has_phone`); use `/reveal` to unlock contact details. At least one filter is required: a non-empty include/exclude dimension, `has_email`, or `has_phone`. Constrained dimensions (`country_code`, `industry_linkedin`, `number_of_employees`, `revenue`, `services`) must use exact values from the Lookups endpoints. Max 50 values per include/exclude list.",
    "properties": {
      "page": {
        "type": "integer",
        "default": 1,
        "minimum": 1
      },
      "per_page": {
        "type": "integer",
        "default": 10,
        "minimum": 1,
        "maximum": 100
      },
      "has_email": {
        "type": "boolean"
      },
      "has_phone": {
        "type": "boolean"
      },
      "company_name": {
        "type": "object",
        "properties": {
          "include": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string"
            }
          },
          "exclude": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "company_url": {
        "type": "object",
        "properties": {
          "include": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string"
            }
          },
          "exclude": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "city": {
        "type": "object",
        "properties": {
          "include": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string"
            }
          },
          "exclude": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "country_code": {
        "type": "object",
        "properties": {
          "include": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string"
            }
          },
          "exclude": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "industry_linkedin": {
        "type": "object",
        "properties": {
          "include": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string"
            }
          },
          "exclude": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "number_of_employees": {
        "type": "object",
        "properties": {
          "include": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string"
            }
          },
          "exclude": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "revenue": {
        "type": "object",
        "properties": {
          "include": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string"
            }
          },
          "exclude": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "title": {
        "type": "object",
        "properties": {
          "include": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string"
            }
          },
          "exclude": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "locality": {
        "type": "object",
        "properties": {
          "include": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string"
            }
          },
          "exclude": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "bio_li": {
        "type": "object",
        "properties": {
          "include": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string"
            }
          },
          "exclude": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "services": {
        "type": "object",
        "properties": {
          "include": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string"
            }
          },
          "exclude": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      }
    },
    "required": [],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.success` | `boolean` | Yes | — | — |
| `result.data.message` | `string` | Yes | — | — |
| `result.data.code` | `integer` | Yes | — | — |
| `result.data.data` | `array` | No | — | — |
| `result.data.data[].document_id` | `string \| null` | No | — | — |
| `result.data.data[].emp_id` | `integer \| null` | No | — | — |
| `result.data.data[].first_name` | `string` | No | — | — |
| `result.data.data[].last_name` | `string` | No | — | — |
| `result.data.data[].title` | `string` | No | — | — |
| `result.data.data[].employee_linkedin` | `string` | No | — | — |
| `result.data.data[].has_email` | `boolean` | No | — | — |
| `result.data.data[].has_phone` | `boolean` | No | — | — |
| `result.data.data[].has_linkedin` | `boolean` | No | — | — |
| `result.data.data[].company_url` | `string` | No | — | — |
| `result.data.data[].company_name` | `string` | No | — | — |
| `result.data.data[].email_domain` | `string` | No | — | — |
| `result.data.data[].home_page_email` | `string` | No | — | — |
| `result.data.data[].company_linked` | `string` | No | — | — |
| `result.data.data[].company_phone` | `string` | No | — | — |
| `result.data.data[].industry` | `string` | No | — | — |
| `result.data.data[].revenue` | `string` | No | — | — |
| `result.data.data[].employee_count` | `string` | No | — | — |
| `result.data.data[].address1` | `string` | No | — | — |
| `result.data.data[].address2` | `string` | No | — | — |
| `result.data.data[].city` | `string` | No | — | — |
| `result.data.data[].region_code` | `string` | No | — | — |
| `result.data.data[].zip` | `string` | No | — | — |
| `result.data.data[].locality` | `string` | No | — | — |
| `result.data.data[].country_code` | `string` | No | — | — |
| `result.data.meta` | `object` | No | — | — |
| `result.data.meta.page` | `integer` | No | — | — |
| `result.data.meta.per_page` | `integer` | No | — | — |
| `result.data.meta.total` | `integer` | No | — | — |
| `result.data.meta.last_page` | `integer` | No | — | — |
| `result.data.meta.reason` | `string` | No | — | — |
| `result.meta` | `object` | 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.",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "message": {
            "type": "string"
          },
          "code": {
            "type": "integer"
          },
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "Masked contact (no email/phone values). Use reveal to unlock.",
              "properties": {
                "document_id": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "emp_id": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "first_name": {
                  "type": "string"
                },
                "last_name": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "employee_linkedin": {
                  "type": "string"
                },
                "has_email": {
                  "type": "boolean"
                },
                "has_phone": {
                  "type": "boolean"
                },
                "has_linkedin": {
                  "type": "boolean"
                },
                "company_url": {
                  "type": "string"
                },
                "company_name": {
                  "type": "string"
                },
                "email_domain": {
                  "type": "string"
                },
                "home_page_email": {
                  "type": "string"
                },
                "company_linked": {
                  "type": "string"
                },
                "company_phone": {
                  "type": "string"
                },
                "industry": {
                  "type": "string"
                },
                "revenue": {
                  "type": "string"
                },
                "employee_count": {
                  "type": "string"
                },
                "address1": {
                  "type": "string"
                },
                "address2": {
                  "type": "string"
                },
                "city": {
                  "type": "string"
                },
                "region_code": {
                  "type": "string"
                },
                "zip": {
                  "type": "string"
                },
                "locality": {
                  "type": "string"
                },
                "country_code": {
                  "type": "string"
                }
              },
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "page": {
                "type": "integer"
              },
              "per_page": {
                "type": "integer"
              },
              "total": {
                "type": "integer"
              },
              "last_page": {
                "type": "integer"
              },
              "reason": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "required": [
          "success",
          "message",
          "code"
        ],
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "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

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