# BuilderVet API API

**Canonical:** https://apis.io/apis/buildervet-au/buildervet-api-api/  
**Provider:** BuilderVet — https://apis.io/providers/buildervet-au/  
**Base URL:** https://api.buildervet.au  
**Documentation:** https://buildervet.au/llms.txt

BuilderVet API API is one of 2 APIs that [BuilderVet](https://apis.io/providers/buildervet-au/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 5 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 5 JSON Schemas.

Dated NSW and QLD licence, company and regulatory evidence. Consult per-source coverage before interpreting an absent finding. No safety rating, phoenix detection, solvency prediction or complete DA coverage. Public evidence is free; paid value is monitoring, private work and exports. Legacy fields

## Operations (27)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/coverage/{slug}` | Per-source check state and timestamps; never inferred from entity update time. |
| POST | `/v1/check/{slug}` | Run a live check of the NSW licence, ASIC and three NSW registers for one builder. Returns at once; poll coverage until lastAttemptAt is at or after startedA... |
| POST | `/v1/hbc-site` | HBC certificates on record for one NSW site address (street number, street and postcode). Covers certificates from licences BuilderVet has read; not proof th... |
| POST | `/v1/quote-match` | Check that the name, ABN or ACN, licence and site address from a quote point to one builder, and whether an HBC certificate for the site is on record. Nothin... |
| GET | `/v1/rewards` | Private watch-credit wallet, own invitation labels/status and bounded history; no cash balance or friend identity. |
| GET | `/v1/rewards/invite` | Public validity and expiry only; no inviter identity or private label. |
| POST | `/v1/rewards/invites` | Create a private single-person invitation; does not send email or messages. Obtain member intent before creating or sharing. |
| POST | `/v1/rewards/redeem` | Spend one owned ready pass on one exact NSW builder. Requires explicit member choice; no swaps. Same credit and builder retries are idempotent. |
| GET | `/v1/workspace` | Private account folders, watches and notifications; no-store. |
| GET | `/v1/billing` | Paid-through rights, legacy rights and checkout availability. |
| POST | `/v1/billing/checkout` | Verified account checkout; total AUD99 homeowner or AUD199 monthly professional. |
| POST | `/v1/billing/portal` | Account-owned Customer Portal; invoices, billing details (business name, ABN, address), cancel professional renewal at period end. |
| GET | `/v1/billing/invoices` | The account's Stripe invoices (latest 100, no drafts), reports bought, and a summary by Sydney calendar month. Stripe is the record; legacy purchases show wi... |
| POST | `/v1/billing/invoices/{invoiceId}/email` | Email a copy of one of the account's invoices to the sign-in address. Three a day per invoice. |
| GET | `/v1/suggest` | Typeahead autocomplete — top 8 matches for a partial name, licence number, ABN or ACN. Edge-cached and fast enough to call per keystroke. |
| GET | `/v1/search` | Search builders by name (optionally filtered by postcode). |
| GET | `/v1/builder/{slug}` | Full risk profile for one builder. |
| GET | `/v1/builder/{slug}/timeline` | Dated event timeline (licence changes, insolvency, disciplinary, etc). |
| GET | `/v1/export` | Bulk export of every builder profile with licences, risk signals and events (used to build the static site; large response). |
| POST | `/v1/waitlist` | Record explicit launch interest in a homeowner report or professional monitoring offer. |
| GET | `/v1/referral` | Referral-ladder progress for a code (count only, never emails). |
| POST | `/v1/watch` | Watch an address for register events (free alerts; explicit consent required). |
| GET | `/v1/watch/unsubscribe` | One-click unsubscribe from alert emails (token from the email footer). |
| POST | `/v1/auth/request-link` | Email a one-time passwordless sign-in link (always returns ok; no account enumeration). |
| GET | `/v1/auth/verify` | Exchange a magic-link token for a session (browser redirect; token from the sign-in email). |
| GET | `/v1/me` | The signed-in account's profile, address watches, referral progress and purchased reports. |
| POST | `/v1/auth/logout` | Revoke the current session token (idempotent). |

## Machine-readable artifacts (6)

- **OpenAPI** — https://artifacts.apis.io/buildervet-au/openapi/_original/buildervet-au-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/buildervet-au/json-schema/buildervet-au-account-view-schema.json
- **JSONSchema** — https://artifacts.apis.io/buildervet-au/json-schema/buildervet-au-builder-profile-schema.json
- **JSONSchema** — https://artifacts.apis.io/buildervet-au/json-schema/buildervet-au-timeline-schema.json
- **JSONSchema** — https://artifacts.apis.io/buildervet-au/json-schema/buildervet-au-search-results-schema.json
- **JSONSchema** — https://artifacts.apis.io/buildervet-au/json-schema/buildervet-au-referral-status-schema.json

## Other BuilderVet APIs (1)

- [BuilderVet API](https://apis.io/apis/buildervet-au/buildervet-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/buildervet-au/buildervet-api-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/buildervet-au/.