---
title: "Get a backorder"
method: GET
path: "/api/backorders/{id}"
tags: ["Backorders"]
---

# Get a backorder

`GET /api/backorders/{id}`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/backorders/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Response `200`

The backorder

- object
  - `backorder` Backorder: A watch on a taken domain that auto-registers it when it drops
    - `id` string
    - `domain` string
    - `status` 'watching' | 'caught' | 'failed' | 'cancelled' | 'expired'
    - `payment_method` 'card' | 'balance'
    - `max_price` number: Max USD you'll pay to catch it
    - `currency` string
    - `domain_expires` string, date-time, nullable: Current registration's expiry (informational)
    - `last_checked` string, date-time, nullable
    - `attempts` integer: Number of availability checks performed
    - `caught_at` string, date-time, nullable
    - `registered_domain_id` string, nullable: ID of the Domain created when caught
    - `failure_reason` 'price_cap' | 'registration_race' | 'marketplace_listing' | 'payment' | 'registrar' | 'unavailable' | 'unexpected' | 'unspecified', nullable: Stable, language-independent failure code. Internal registrar prose is never returned.
    - `expires_at` string, date-time: When the watch window ends
    - `created_at` string, date-time

## Other responses

- `404`: Backorder not found

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)
