# Recipient suggestions

`GET /api/v1/emails/recipients`

Up to 8 suggestions for the To / Cc field: contacts of visible companies (`k: contact`, company name `c`, `fm` left the company), teammates (`k: user`) and external addresses you have written to under open visibility (`k: peer`). Matches the start of the address, the name or the company name; `customer_id` ranks that company's contacts first (with an empty `q` it lists only them), `ex` lists addresses already entered.

## Query parameters

| Field | Type | Description |
|---|---|---|
| `q` | string | Typed text. |
| `customer_id` | integer | The draft's company. |
| `ex` | string | Addresses to exclude (comma separated). |