---
title: "List your backorders"
method: GET
path: "/api/backorders"
tags: ["Backorders"]
---

# List your backorders

`GET /api/backorders`

## Request

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

Returns your backorders, newest first. Filter by `status` (watching, caught, failed, cancelled, expired).

## Query parameters

- `status` 'watching' | 'caught' | 'failed' | 'cancelled' | 'expired'

## Response `200`

Your backorders

- object
  - `backorders` Backorder[]
    - `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

---

[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)