# skipTraceProperty

Skip-trace a property (by id/esId) to discover its owner and their phone numbers/emails. Returns the discovered people inline; re-read them later (free) with getPropertyOwners. CONSUMES ONE SKIPTRACE CREDIT (plan allowance first except in a trial, then real money; checkBillingAction): requires the ADMIN scope, and the key owner must be a team admin.

- Call: `POST https://server.goliathdata.com/api/v1/call` with `{ "operationId": "skipTraceProperty", "variables": {...} }`
- Scope: `ADMIN`
- Type: mutation
- Idempotency: honors `Idempotency-Key` (24 h)
- Rate-limited: no

## Variables

- `propertyId`: `ID!` (required)

## Response (data, an example)

```json
{
  "skiptraceMutation": {
    "skipTraceProperty": {
      "id": "<ID>",
      "skipTraceStatus": "PROCESSING",
      "lastSkiptracedAt": "2026-01-01T00:00:00.000Z",
      "isStaleSkiptrace": true,
      "address": {
        "addressFull": "…"
      },
      "people": [
        {
          "id": "…",
          "firstName": "…",
          "middleName": "…",
          "lastName": "…",
          "suffix": "…",
          "age": 0,
          "phoneNumbers": [
            {
              "number": "…",
              "type": "…",
              "ranking": 0,
              "dncStatus": {
                "isDnc": true,
                "isLitigator": true
              }
            }
          ],
          "emails": [
            {
              "email": "…",
              "ranking": 0
            }
          ],
          "isRelative": true,
          "relativeIds": [
            "…"
          ],
          "ranking": 0,
          "deceased": true,
          "isNameOnDeed": true
        }
      ]
    }
  }
}
```

## Example

```bash
curl https://server.goliathdata.com/api/v1/call \
  -H "Authorization: Bearer $GOLIATH_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "operationId": "skipTraceProperty",
    "variables": {
      "propertyId": "<propertyId>"
    }
  }'
```