# Contacts

A person's verified work email and mobile number, by LinkedIn handle. This is the tool for "how do I reach this person": ops: reveal (up to ten people by /in/ handle or profile URL; reveal=\["email","phone"\] by default, \["email"\] alone when the number is not needed — a phone costs about five emails' worth). The handle must come from EVIDENCE: web-search the person, or find them with linkedin searchPeople, and use the /in/ you SAW — a handle typed from a name bills real credits and can reveal a DIFFERENT person's number. A reveal is YOUR org's asset: a part you already own is free, a part with nothing on file is answered once and never bought again, and nothing revealed is ever shared with another org. Batch subjects inside one call; estimate\_only=true quotes without spending.

`POST https://api.zomler.com/api/v1/platforms/contacts`

-   [reveal](#reveal)

## reveal

from 105 credits

Work email and mobile number for up to ten people, by LinkedIn /in/ handle or profile URL. A reveal is the BUYER'S asset: billed per person and per part, owned by your org, never shared with another org. A part you already own is free; only the missing part is bought.

### Request fields

| Field | Type | Default | Values / limits |
| --- | --- | --- | --- |
| `subjects` (required) | list of string | — | 1-10 items |
| `reveal`◆ | list of enum | `['email', 'phone']` | `email`, `phone` |

### Example

```bash
curl -X POST https://api.zomler.com/api/v1/platforms/contacts \
  -H "X-API-Key: zk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "request": {
    "op": "reveal",
    "subjects": [
      "example"
    ]
  },
  "estimateOnly": false
}'
```

```js
const res = await fetch("https://api.zomler.com/api/v1/platforms/contacts", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.ZOMLER_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "request": {
      "op": "reveal",
      "subjects": [
        "example"
      ]
    },
    "estimateOnly": false
  }),
});
const envelope = await res.json();
console.log(envelope.data, envelope.cost.creditsCharged);
```

```python
import os, httpx

res = httpx.post(
    "https://api.zomler.com/api/v1/platforms/contacts",
    headers={"X-API-Key": os.environ["ZOMLER_API_KEY"]},
    json={
      "request": {
        "op": "reveal",
        "subjects": [
          "example"
        ]
      },
      "estimateOnly": False
    },
    timeout=120,
)
envelope = res.json()
print(envelope["data"], envelope["cost"]["creditsCharged"])
```

---

Source: https://zomler.com/docs/api/platforms/contacts