DomainTree home
AuctionsBackordersSellHosted catchingDomains for sale
Sign inCreate account

DomainTree API

Book and manage UK domain backorders from your own code. This is the same booking engine as the website, so a backorder placed through the API is binding in exactly the same way: if DomainTree catches the name and you are the only backorderer, you pay £50; if others backordered it too, it goes to auction and the first backorder becomes the opening £50 bid.

Base URL

All endpoints live under:

https://domaintree.co.uk/api/v1

The API is HTTPS only. Times are UTC ISO-8601 with a Z suffix (for example 2026-11-18T09:00:00Z). Money is always an integer number of pence (so £50 is 5000).

Authentication

Create a key on your account page under API access. The full key is shown once, on creation — copy it then, because it is never shown again and we never store it (we keep only a one-way hash). A key looks like dt_live_ followed by 64 hex characters.

Send it on every request as a bearer token:

Authorization: Bearer dt_live_0123456789abcdef...

You can revoke a key at any time from the same page. You may pin a key to one or more IP addresses when you create it.

The response envelope

Every response is JSON and carries an ok flag.

Success:

{ "ok": true, ... }

Failure:

{ "ok": false, "error": { "code": "bad_request", "message": "A human-readable explanation." } }

Rate limits

  • Each key may make a limited number of requests per 15 minutes (see requests_per_15min in GET /me).
  • Booking (write) calls are also limited per source address.
  • Presenting too many bad keys from one address blocks that address for a while.

When a limit is hit you get 429 with a Retry-After header (whole seconds).

The 5-minute cutoff

Once a name has a known drop time, new backorders are refused from 5 minutes before the drop, and you cannot change a maximum bid inside that window.

---

POST /backorders — book up to 50 names

Request body (max_bid_pence is optional per item; omit it for the plain £50 sole-backorder promise):

{
  "domains": [
    { "domain": "example.co.uk", "max_bid_pence": 25000 },
    { "domain": "another.uk" }
  ]
}

Response — one result per name, plus your current usage:

{
  "ok": true,
  "booked": 1,
  "results": [
    { "domain": "example.co.uk", "result": "placed", "backorder_id": 12, "status": "checking", "drop_at": null },
    { "domain": "another.uk", "result": "duplicate", "backorder_id": 9, "status": "scheduled" }
  ],
  "usage": { "placed_last_hour": 3, "per_hour_cap": 50, "live": 7, "live_cap": 50 }
}

Per-name result is one of: placed, duplicate, too_many (your hourly cap), too_many_live (your live-backorder cap), cutoff (too close to the drop), invalid (the name or maximum is not acceptable), or refused.

More than 50 names returns 400 too_many_names.

GET /backorders — your live backorders

{
  "ok": true,
  "backorders": [
    { "id": 12, "domain": "example.co.uk", "status": "scheduled",
      "drop_at": "2026-12-01T09:00:00Z", "max_bid_pence": 25000,
      "created_at": "2026-11-18T10:00:00Z" }
  ]
}

DELETE /backorders/{id} — cancel

Cancels your backorder if it is still live and more than 2 days before a known drop.

{ "ok": true, "id": 12, "domain": "example.co.uk", "status": "cancelled" }

404 not_found if it is not yours; 409 not_cancellable or 409 too_late if it can no longer be cancelled here (email us to cancel after that).

POST /backorders/{id}/max — set or clear a maximum bid

{ "max_bid_pence": 25000 }

Send "max_bid_pence": null to clear it. A maximum must be at least 5000 (£50). Response:

{ "ok": true, "id": 12, "domain": "example.co.uk", "max_bid_pence": 25000 }

GET /check/{domain} — a cheap pre-check

No registry lookup. Tells you whether a name is bookable:

{ "ok": true, "domain": "example.co.uk", "state": "bookable", "drop_at": null }

state is bookable, yours (you already hold a backorder on it), listed (a drop is known or it is on the drop list — drop_at is set when known) or invalid.

GET /me — your account and caps

{
  "ok": true,
  "account_id": 42,
  "email": "[email protected]",
  "per_hour_cap": 50,
  "max_live": 50,
  "placed_last_hour": 3,
  "live_count": 7,
  "requests_per_15min": 300,
  "key": { "label": "my script", "prefix": "dt_live_0123abcd" }
}

GET /catches?since=YYYY-MM-DD — your resolved backorders

Backorders that have been through a drop. Defaults to the last 30 days; at most 500 rows.

{
  "ok": true,
  "since": "2026-10-19T00:00:00Z",
  "catches": [
    { "domain": "example.co.uk", "caught": true, "outcome": "sold",
      "price_pence": 5000, "payment_status": "paid", "sale_id": 3,
      "drop_at": "2026-11-01T09:00:00Z" },
    { "domain": "other.uk", "caught": false, "outcome": "missed",
      "price_pence": null, "payment_status": null, "sale_id": null,
      "drop_at": "2026-11-02T09:00:00Z" }
  ]
}

outcome is sold (a sole £50 sale to you), auction (it went to auction), caught (caught, awaiting its outcome) or missed.

GET /domains — names caught and held for you

{
  "ok": true,
  "domains": [
    { "domain": "example.co.uk", "held_for_you": true, "price_pence": 5000,
      "payment_status": "paid", "sale_id": 3,
      "releasable": false,
      "note": "Release to your own tag is not yet available via the API — contact us." }
  ]
}

Release to your own tag is coming soon. releasable is always false for now; to have a caught name released to your own Nominet tag, contact us.

---

Status codes and error codes

HTTPcodemeaning
200—success ("ok": true)
400bad_requestsomething in the request is wrong
400bad_jsonthe body is not valid JSON
400too_many_namesmore than 50 names in one booking call
400invalida field (e.g. the maximum bid) is out of range
401unauthorisedmissing or invalid key
401key_revokedthe key has been revoked
403forbiddenyour account may not do this, or the key is barred from your address
404not_foundno such item, or not yours
409not_cancellablethe backorder can no longer be cancelled
409not_activethe backorder is no longer live
409too_latepast the cutoff for this change
429rate_limitedtoo many requests for this key or address (see Retry-After)
429ip_blockedtoo many bad keys from your address (see Retry-After)
© 2026 DomainTree · UK domain catching, backorders and auctions
Domains for saleSell your domainHosted catchingDomain name policiesTermsPrivacy noticeCookiesHow it worksContactRSS feeds