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_15mininGET /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
| HTTP | code | meaning |
|---|---|---|
| 200 | — | success ("ok": true) |
| 400 | bad_request | something in the request is wrong |
| 400 | bad_json | the body is not valid JSON |
| 400 | too_many_names | more than 50 names in one booking call |
| 400 | invalid | a field (e.g. the maximum bid) is out of range |
| 401 | unauthorised | missing or invalid key |
| 401 | key_revoked | the key has been revoked |
| 403 | forbidden | your account may not do this, or the key is barred from your address |
| 404 | not_found | no such item, or not yours |
| 409 | not_cancellable | the backorder can no longer be cancelled |
| 409 | not_active | the backorder is no longer live |
| 409 | too_late | past the cutoff for this change |
| 429 | rate_limited | too many requests for this key or address (see Retry-After) |
| 429 | ip_blocked | too many bad keys from your address (see Retry-After) |