Quickstart

By the end you’ll have a working API key and a domain registered against your org’s balance. Five minutes if you’re not stopping for tea.

Prerequisites

A DomainGenius account (sign up — free).
A bun or curl you can run.
For .au domains: an ABN. Other TLDs have no eligibility check.

1. Top up the org balance

In the dashboard, Billing → Top up. $50 is plenty for a .com.au.

2. Mint an API key

API keys → New key. Give it availability:read and domains:write. Copy the value (it’s only shown once).

bash

export DG_KEY=dg_live_...

3. Find your org OID

bash

curl -s https://api.domaingenius.com.au/api/v1/me/orgs \
  -H "Authorization: Bearer $DG_KEY" | bun -e \
  'const r = await Bun.stdin.json(); console.log(r.items[0].oid);'

Output

text

org_01HF82YV...

bash

export DG_ORG=org_01HF82YV...

4. Check availability

bash

curl "https://api.domaingenius.com.au/api/v1/domains/availability?domain=hello-world.com.au" \
  -H "Authorization: Bearer $DG_KEY"

json

{
  "domain": "hello-world.com.au",
  "available": true,
  "register_price_aud": 24.95
}

5. Register it

bash

curl -X POST "https://api.domaingenius.com.au/api/v1/orgs/$DG_ORG/domains/hello-world.com.au/register" \
  -H "Authorization: Bearer $DG_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "years": 1 }'

json

{
  "status": "registered",
  "domain": "hello-world.com.au",
  "expires_at": "2027-05-01T00:00:00Z"
}

The domain shows up in the dashboard immediately. DNS, contacts, and forwarding can be configured next — see the relevant guides.

What now

Configure DNS

Add A, MX, TXT records or apply a preset.

Set contacts

Registrant, admin, technical, billing.

Try the MCP

Drive the same flows from Claude or Cursor.

Read the API reference

Every endpoint, with a try-it.

Last updated just now Edit this page