Add a new address

Add a new address for IPND emergency services location purposes.

This endpoint allows adding a new address that can be associated with phone numbers (DIDs). The address information is used by emergency services to locate the physical address of the phone number in case of emergency.

⚠️ IMPORTANT LEGAL NOTICE You are legally responsible for ensuring that all address information provided is true, accurate, and complete. Incorrect information may impact emergency services response and could have serious consequences. Providing false information may result in legal penalties under telecommunications and emergency services regulations.

Required Fields (Mandatory for new addresses)

  • city: City/suburb name (string)
  • state: State code e.g., NSW, VIC (string)
  • postcode: Australian postal code (string)

Optional Fields (All fields accept null)

  • nickname: Friendly name for the address (string|null)
  • unit_number: Unit number (string|null)
  • unit_number_suffix: Suffix for unit number (string|null)
  • unit_number_end: For unit ranges - end number (string|null)
  • unit_number_end_suffix: Suffix for end unit number (string|null)
  • level_number: Level number (string|null)
  • level_suffix: Suffix for level number (string|null)
  • building_name: Name of building (string|null)
  • building_location: Location within building (string|null)
  • street_number_pretty: Formatted street number (string|null)
  • street_number_first: First street number (string|null)
  • street_number_first_suffix: Suffix for first street number (string|null)
  • street_number_last: Last street number for ranges (string|null)
  • street_number_last_suffix: Suffix for last street number (string|null)
  • street_name: Name of street (string|null)
  • street_2_name: Secondary street name for corners (string|null)
  • gnaf_id: GNAF identifier (string|null)
  • country: Country name (string|null, defaults to "Australia")

Optional Enumerated Fields (All accept null)

Unit Type (unit_type)

Enum values (string|null):

CodeDescription
ATMAutomated Teller Machine
BTSDBoatshed
COOLCoolroom
DUPLDuplex
FCTYFactory
FLATFlat
LBBYLobby
LOFTLoft
MBTHMarine Berth
OFFCOffice
RESVReserve
ROOMRoom
STLLStall
STORStore
STRStrata Unit
UNITUnit
WHSEWarehouse
WKSHWorkshop
ANTAntenna
APTApartment
BBQBarbecue
BLCKBlock
BLDGBuilding
BNGWBungalow
CAGECage
CARPCarpark
CARSCarspace
CLUBClub
CTGECottage
GRGEGarage
HALLHall
HSEHouse
KSKKiosk
LOTLot
LSELease
MSNTMaisonette
PTHSPenthouse
REARRear
SESuite
SECSection
SHEDShed
SHOPShop
SHRMShowroom
SIGNSign
SITESite
STUStudio
SUBSSubstation
TNCYTenancy
TNHSTownhouse
TWRTower
VLLAVilla
VLTVault
WARDWard
RTCERoof Terrace

Level Type (level_type)

Enum values (string|null):

CodeDescription
ODObservation Deck
PParking
PDMPodium
PLFPlatform
PTHSPenthouse
SBSub Basement
BBasement
FLFloor
GGround
LLevel
LBLobby
LGLower Ground Floor
MMezzanine
RTRooftop
UGUpper Ground Floor
UNGDUnderground

Street Type (street_type and street_2_type)

Enum values (string|null):

CodeDescription
STStreet
RDRoad
AVEAvenue

Street Suffix (street_suffix and street_2_suffix)

Enum values (string|null):

CodeDescription
DEDeviation
OPOverpass
CNCentral
EEast
EXExtension
INInner
LRLower
MLMall
NNorth
NENorth East
NWNorth West
OFOff
ONOn
OTOuter
SSouth
SESouth East
SWSouth West
UPUpper
WWest
Language
Credentials
Header
Click Try It! to start a request and see the response here!