# findSharedPhonesAndEmails

Groups of 2+ contacts carrying the same phone number (kind PHONE, the default) or email (kind EMAIL), WHATEVER THEIR NAMES, largest first, in ONE call: value (10-digit number or lowercase email), memberCount (every contact you see carrying it: say this number), members (the first 25, VERIFIED holders first) with their statuses for it. "How many times does this number show up", "who else has this number", a household or family on one line: this, not findDuplicateContactGroups (same name only). Never counted: a number marked WRONG, a relative's (sub-contact) number, a reserved-domain email (example.com). totalCount = groups across everything you see.

- Call: `POST https://server.goliathdata.com/api/v1/call` with `{ "operationId": "findSharedPhonesAndEmails", "variables": {...} }`
- Scope: `READ`
- Type: query
- Idempotency: a read; rejects `Idempotency-Key`
- Rate-limited: no
- Result cap: `limit` is clamped to 100, without an error

## Variables

- `kind`: `SharedContactInfoKind` (default `PHONE`, one of `PHONE`, `EMAIL`). Which value contacts are grouped on when they share it.
- `limit`: `Int` (default `50`)
- `offset`: `Int` (default `0`)

## Response (data, an example)

```json
{
  "contactQuery": {
    "sharedContactInfoGroups": {
      "groups": [
        {
          "value": "…",
          "memberCount": 0,
          "members": [
            {
              "id": "<ID>",
              "name": "…",
              "statuses": [
                "VERIFIED"
              ]
            }
          ]
        }
      ],
      "totalCount": 0,
      "truncated": true,
      "hasMore": true
    }
  }
}
```

## Example

```bash
curl https://server.goliathdata.com/api/v1/call \
  -H "Authorization: Bearer $GOLIATH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "operationId": "findSharedPhonesAndEmails",
    "variables": {}
  }'
```
