TypeScript SDK

import { Prontiq } from "@prontiq/sdk";

const prontiq = new Prontiq({
  serverURL: "https://api.prontiq.dev",
  apiKeyAuth: process.env.PRONTIQ_API_KEY!,
});

const autocompleteResponse = await prontiq.address.autocompleteAddress(
  "8 noble way", // q
  "WA", // state (optional)
  5, // limit (optional)
);
const { suggestions, total } = autocompleteResponse.result;
// For Autocomplete, total is the number of suggestions returned.

for (const s of suggestions) {
  console.log(`${s.addressLabel} ${s.localityName} ${s.state} ${s.postcode}`);
}

const validateResponse = await prontiq.address.validateAddress("8 noble way success wa 6164");
const { match, prontiqMatchScore, prontiqMatchQuality } = validateResponse.result;

if (prontiqMatchQuality === "high") {
  console.log(`Verified (${prontiqMatchScore}/100): ${match?.addressLabel}`);
}

const enrichResponse = await prontiq.address.enrichAddress("GAWA_147231326");
const address = enrichResponse.result;

console.log(address.geocode); // { latitude, longitude, type, reliability }
console.log(address.boundaries); // { lga, stateElectorate, meshBlock, sa2, ... }
console.log(address.components?.streetNumberFirst);
console.log(address.boundaries?.sa1);
console.log(address.aliases ?? []);

const reverseResponse = await prontiq.address.reverseGeocodeAddress({
  lat: -33.8568,
  lon: 151.2153,
  radius: 200,
  limit: 3,
});
const { results } = reverseResponse.result;

for (const r of results) {
  console.log(`${r.addressLabel} — ${r.distanceM}m away`);
}

// Postcode → localities
const postcodeResponse = await prontiq.address.lookupPostcode("2000");
const { localities } = postcodeResponse.result;

// Suburb → postcodes
const suburbResponse = await prontiq.address.lookupSuburb("bondi beach", "NSW");
const { postcodes, addressCount } = suburbResponse.result;

import { SDKValidationError } from "@prontiq/sdk/models/errors";

try {
  const result = await prontiq.address.autocompleteAddress("test");
} catch (err) {
  if (err instanceof SDKValidationError) {
    console.error("Validation:", err.message);
  }
  throw err;
}