# findSharedPropertyAddresses

Groups of 2+ contacts linked to the same property address (the parcel, else the mailing address row, else the text folded for case and punctuation), largest first, in ONE call: address, propertyId, members with how each is linked (OWNS, MAILING, FORMER_OWNER, RELATED_TO_OWNER). totalCount = groups across everything you see.

- Call: `POST https://server.goliathdata.com/api/v1/call` with `{ "operationId": "findSharedPropertyAddresses", "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

- `limit`: `Int` (default `50`)
- `offset`: `Int` (default `0`)

## Response (data, an example)

```json
{
  "contactQuery": {
    "sharedPropertyAddressGroups": {
      "groups": [
        {
          "address": "…",
          "propertyId": "<ID>",
          "members": [
            {
              "id": "<ID>",
              "name": "…",
              "relations": [
                "…"
              ]
            }
          ]
        }
      ],
      "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": "findSharedPropertyAddresses",
    "variables": {}
  }'
```