---
title: "Watch an address for register events (free alerts; explicit consent required)."
method: POST
path: "/v1/watch"
---

# Watch an address for register events (free alerts; explicit consent required).

`POST /v1/watch`

## Request

- Base URL: `https://api.buildervet.au`
- URL: `https://api.buildervet.au/v1/watch`
- Auth: none declared

## Request body

- object
  - `email` string, email, required
  - `address` string, required
  - `postcode` string
  - `builderName` string
  - `consent` boolean, required
  - `ref` string

## Response `200`

OK; returns the email's referral code and referral count.

- ReferralStatus
  - `ok` boolean
  - `refCode` string: This email's shareable referral code.
  - `referrals` integer: Distinct emails referred by this code.

## Other responses

- `400`: Invalid email

---

[API](https://skmtc.dev/buildervet/apis/buildervet-api.md) · [All operations](https://skmtc.dev/buildervet/apis/buildervet-api/llms.txt) · [OpenAPI document](https://skmtc.dev/buildervet/apis/buildervet-api/revisions/8ac7930a2aad?raw)