Pending-Delete

List pending-delete domains (Authority+)

Weekly inventory of domains about to drop across 125+ ccTLDs and gTLDs. Default view (week_end=all) returns upcoming drops only, soonest first; rows whose estimated drop date already passed are excluded unless include_past=1. Requires an Authority+ subscription (403 with upgrade_url otherwise).

get/pending-delete

Request

  • Base URL: https://catchdoms.com/api
  • URL: https://catchdoms.com/api/pending-delete
  • Auth: HTTP bearer

Query parameters

tldstring
Example:fr,de,com

Comma-separated TLD list, with or without leading dot

statusstring
Example:pendingDelete,redemptionPeriod

Comma-separated WHOIS status filter

source'oi-diff' | 'czds-daily'

Pipeline source

week_endstring

Snapshot week (YYYY-MM-DD) or 'all' (combined view). Explicit weeks include historical rows regardless of drop date.

drops_withininteger

Only rows whose estimated drop date is within N days from today (never past dates)

containsstring

Substring match on the domain name

no_dashesboolean

Exclude SLDs containing hyphens

no_numbersboolean

Exclude SLDs containing digits

include_pastboolean

With week_end=all, also return rows whose estimated drop date already passed

sort'drop_date' | 'drop_date_desc' | 'domain'

Ordering. drop_date = soonest first, rows without a computable date last. drop_date_desc lists rows without a date first; combine with drops_within to keep dated rows only.

per_pageinteger

Results per page (this endpoint uses per_page, not limit)

pageinteger

Page number

Response

Paginated list of pending-delete domains

Example response

{
  "data": [
    {
      "domain": "example.fr",
      "tld": "fr"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.