# Search Australian businesses

Preview: Find Australian businesses by name, with state, postcode and active-status filters.

Canonical: https://aroai.com/tools/au_abn_search/

## Tool reference

MCP tool ID: `au_abn_search`. Availability: Preview. Country: Australia. Credit use: 1 credit.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200
    },
    "limit": {
      "default": 5,
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    },
    "state": {
      "type": "string",
      "enum": [
        "NSW",
        "VIC",
        "QLD",
        "SA",
        "WA",
        "TAS",
        "NT",
        "ACT"
      ]
    },
    "postcode": {
      "type": "string",
      "pattern": "^\\d{4}$"
    },
    "active_only": {
      "type": "boolean"
    },
    "detail": {
      "default": "standard",
      "type": "string",
      "enum": [
        "summary",
        "standard",
        "full"
      ]
    },
    "fields": {
      "maxItems": 30,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$"
      }
    }
  },
  "required": [
    "query",
    "limit",
    "detail"
  ],
  "additionalProperties": false
}
```

## Example input

```json
{
  "query": "Example",
  "state": "NSW",
  "active_only": true,
  "limit": 5,
  "detail": "standard"
}
```

## Usage notes

- Costs one credit per search, including when you use a supported workspace registry key.
- Returns up to ten candidate matches. Resolve the intended business before opening its record.
- Search by business name; use au_abn_get when you already have an 11-digit ABN.