> For the complete documentation index, see [llms.txt](https://docs.mastersoftgroup.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mastersoftgroup.com/loqate-harmony-api/demos/address-validation-demo.md).

# Address Validation Demo

### Prerequisites

Before you begin you will need a Loqate Harmony Account. 

If you do not have Harmony API account you register a free trial.

{% embed url="<https://www.loqate.com/anz/register/>" %}

### Address Lookup & Validation Demo

You can demo the service from within the Harmony API Console by signing up for a trial or navigating to API Demo.

<figure><img src="/files/EO7BONwsslOitYxqWzqt" alt=""><figcaption></figcaption></figure>

Alternatively, using your API keys within domain access to cdpn.io. See our guide on [how to use our demo's](/loqate-harmony-api/demos.md#how-to-use-our-demos). Further guides are below the Codepen

<https://codepen.io/loqateanz/full/oNmxgXq>

### Demo Guide

Once you enter your credentials and click start. The demo will appear below.

Simply start typing an address into the input field. After 3 characters you will see suggestions, click on a suggestion and the full response package becomes available.

#### **Common Options to change**

In Setting the Options button gives you all the API options that you set for different uses for this API.&#x20;

#### **Common Options**

In Setting the Options button gives you all the API options that you set for different uses for this API.&#x20;

***Country:*** Set to the target country.

***Source of Truth:*** AU & NZ offer selections of datasets to access.

***Address grouping:*** valid for certain countries / data sources

***Hits:** Alters the amount of results our API returns on a Find request*

***State:** Filters results to a specific state or region in AU & NZ*

#### Any Order Feature

Any Order feature allows addresses to be entered in Any order and they will be found.&#x20;

* Street Number, Street Name, Suburb&#x20;
* Suburb, Street Number, Street Name
* Postcode, State, Street Name, Street Number
* Try Any Order you like - it still works.

**Accurate Data**

Try '99999 George Street Sydney'. This does not exist in real life. We return no result because its not real.

### Related API Specification

{% content-ref url="/pages/5ylNPVUFqxzdVXGnD8kk" %}
[Address Validation & Lookup](/loqate-harmony-api/api-specification/address/address-validation-and-lookup.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.mastersoftgroup.com/loqate-harmony-api/demos/address-validation-demo.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.