---
title: "Search builders by name (optionally filtered by postcode)."
method: GET
path: "/v1/search"
---

# Search builders by name (optionally filtered by postcode).

`GET /v1/search`

## Request

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

## Query parameters

- `q` string, required
- `postcode` string

## Response `200`

Matches

- SearchResults
  - `query` string
  - `results` object[]
    - `slug` string
    - `displayName` string
    - `postcode` string, nullable
    - `status` string, nullable

## Other responses

- `400`: Query shorter than 2 characters

---

[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)