.com.au

Registration terms: 1–5 years. Transfers in are supported with an authorisation code. Registration waits for registry documents. 8 extra registry fields (0 required).

• Registry documents are required. The domain waits in a pending state until you upload documents and the registry approves them.
• This extension has extra registry fields — see Extra fields below. Which ones you must send can depend on the value of another field.

At a glance

Property	Value
Registration terms	1–5 years
Renewal terms	1–10 years
Transfer in	Supported · authorisation code required · pre-transfer check not available
Transfer lock	Not available
Extra registry fields	8 — see below
Registry documents	Required
Trustee service	Not available
WHOIS privacy	Available
DNSSEC	Supported
IDN (non-ASCII names)	Supported
Name servers under the domain	Not allowed
Contact change by handle	Not available — send full details
Registry checks name servers	No
Test environment	Available

What each property means and which error you get if you ignore it: TLD catalogue.

Lifecycle

In calendar days. — means the registry does not publish the period.

Period	Days	What happens
Add grace	—	Deleting a new registration within this window is refunded.
Auto-renew grace	20	After expiry the registry renews automatically; a second renewal in this window is refused with 10020.
Redemption	30	After deletion, POST /api/v1/domains/restore still works.
Deletion hold	—	After redemption, before the name is released to the public. Nothing can be done.

Extra fields (tldAttributes)

Send these as a flat key/value object named tldAttributes on register requests. See Extra registry fields.

Key	Required	Type	Description	Allowed values
X-AU-OWNER-ORGANIZATION	optional	Text	Registrant Organisation Name	Free text
X-AU-DOMAIN-IDTYPE	optional	DropdownList	Registrant ID Type	ABN, ACT, VIC, SA, TM, WA, QLD, TAS, NT, NSW, ACN
X-AU-ELIGIBILITY-NAME	optional	Text	Eligibility Name	Free text
X-AU-DOMAIN-IDNUMBER	optional	Text	Registrant ID Number	Free text
X-AU-ELIGIBILITY-IDTYPE	optional	DropdownList	Eligibility ID Type	ACT, ACN, QLD, SA, NT, TM, ABN, WA, NSW, VIC, TAS
X-AU-DOMAIN-RELATION	optional	DropdownList	Domain Name Relation	2, 1
X-AU-ELIGIBILITY-IDNUMBER	optional	Text	Eligibility ID Number	Free text
X-AU-DOMAIN-RELATIONTYPE	optional	DropdownList	Eligibility Type	EducationAndCareServicesChildCare, Company, RegisteredOrganisation, CommonwealthEntity, EducationalInstitution, Preschool, ProviderOfNonAccreditedTraining, GovernmentSchool, IncorporatedAssociation, NationalBody, Cooperative, NonTradingCooperative, TradingCooperative, NonDistributingCooperative, IndustryBody, Partnership, PoliticalParty, IndigenousCorporation, IndustryOrganisation, ReligiousChurchGroup, PublicPrivateAncillaryFund, GovernmentBody, Charity, CommercialStatutoryBody, RegistrableBody, StatutoryBody, club, UnincorporatedAssociation, TradeUnion, CharitableTrust, NonProfitOrganisation, Trust, ResearchOrganisation, HigherEducationInstitution, RegisteredBusiness, ChildCareCentre, TrainingOrganisation, CompanyLimitedByGuarantee, NonGovernmentSchool, SoleTrader, TrademarkOwner, PeakStateTerritoryBody, PendingTMOwner

Ready-to-send requests

Each request below is built from this extension’s catalogue entry. Replace the domain, the handles and any value in <angle brackets>.

Register

POST /api/v1/domains/register with contact handles you created with POST /api/v1/contacts. To send contact details inline instead, use POST /api/v1/domains/register-with-contacts with the same tldAttributes.

tldAttributes lists every field this extension defines. Send the ones that apply: the table above says which are required, and some become required only for a particular value of another field.

{
  "domainName": "apiname.com.au",
  "period": 1,
  "nameServers": [
    "tr.apiname.com",
    "eu.apiname.com"
  ],
  "handles": [
    { "contactType": "Registrant", "handle": "D-174829301847" },
    { "contactType": "Admin", "handle": "D-174829301847" },
    { "contactType": "Tech", "handle": "D-174829301847" },
    { "contactType": "Billing", "handle": "D-174829301847" }
  ],
  "tldAttributes": {
    "X-AU-OWNER-ORGANIZATION": "<Registrant Organisation Name>",
    "X-AU-DOMAIN-IDTYPE": "ABN",
    "X-AU-ELIGIBILITY-NAME": "<Eligibility Name>",
    "X-AU-DOMAIN-IDNUMBER": "<Registrant ID Number>",
    "X-AU-ELIGIBILITY-IDTYPE": "ACT",
    "X-AU-DOMAIN-RELATION": "2",
    "X-AU-ELIGIBILITY-IDNUMBER": "<Eligibility ID Number>",
    "X-AU-DOMAIN-RELATIONTYPE": "EducationAndCareServicesChildCare"
  }
}

Renew

POST /api/v1/domains/renew — call POST /api/v1/domains/renew/check with the same body first. See Renew a domain.

{
  "domainName": "apiname.com.au",
  "period": 1
}

Transfer in

POST /api/v1/domains/transfer. This registry has no pre-transfer check, so call it directly. See Transfer a domain in.

{
  "domainName": "apiname.com.au",
  "authCode": "aB3!xY9-kL2pQ7",
  "period": 1
}

From the TLD catalogue on 2026-11-02. For live values call GET /api/v1/products/tlds?filterText=com.au.