# .id.au

> Rules for .id.au domains: terms, transfer, extra registry fields and ready-to-send JSON for register, renew and transfer.

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

- **This extension has extra registry fields** — see [Extra fields](#extra-fields-tldattributes) below. Which ones you must send can depend on the value of another field.

## At a glance

| Property | Value |
| --- | --- |
| Registration terms | 1–10 years |
| Renewal terms | 1–10 years |
| Transfer in | Supported · authorisation code required · pre-transfer check not available |
| Transfer lock | Can be turned on and off |
| Extra registry fields | 8 — see [below](#extra-fields-tldattributes) |
| Registry documents | Not 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 | Available |
| Registry checks name servers | No |
| Test environment | Available |

What each property means and which error you get if you ignore it: [TLD catalogue](https://www.domainnameapi.com/docs/catalogue/#every-field-and-what-to-do-with-it).

## 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](https://www.domainnameapi.com/docs/domains/#extra-registry-fields-tldattributes).

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

## 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`](https://www.domainnameapi.com/docs/domains/register/#registering-with-contact-details) 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.

```json
{
  "domainName": "apiname.id.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-IDNUMBER": "<Registrant ID Number>",
    "X-AU-DOMAIN-RELATIONTYPE": "ReligiousChurchGroup",
    "X-AU-ELIGIBILITY-IDTYPE": "SA",
    "X-AU-ELIGIBILITY-IDNUMBER": "<Eligibility ID Number>",
    "X-AU-DOMAIN-IDTYPE": "ACN",
    "X-AU-DOMAIN-RELATION": "2",
    "X-AU-ELIGIBILITY-NAME": "<Eligibility Name>"
  }
}
```

### Renew

`POST /api/v1/domains/renew` — call `POST /api/v1/domains/renew/check` with the same body first. See [Renew a domain](https://www.domainnameapi.com/docs/domains/renew/).

```json
{
  "domainName": "apiname.id.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](https://www.domainnameapi.com/docs/domains/transfer/).

```json
{
  "domainName": "apiname.id.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=id.au`.*