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

# Search Contacts

`outlook_search_contacts`

Searches contacts by name, email address, company, or other fields. Returns matching contacts up to the specified limit.

<Warning>
  Contact search does not support offset paging — results are unordered and only a single page is returned up to `limit`. Use `outlook_list_contacts` with pagination if you need to browse the full address book.
</Warning>

## Parameters

| Parameter         | Type   | Required | Description                                                       |
| ----------------- | ------ | -------- | ----------------------------------------------------------------- |
| `query`           | string | Yes      | Search term — e.g. `"Alice"`, `"Contoso"`, `"alice@example.com"`. |
| `limit`           | number | No       | Max contacts to return (1–100, default 20).                       |
| `response_format` | string | No       | Output format: `"markdown"` (default) or `"json"`.                |

## Returns

An array of matching contact objects with the same fields as `outlook_list_contacts`.

## Example use

> "Find the contact details for Alice from Contoso."