Drop catch

Watched domains.

Common tasks

List watched domains

Only in the app: Adding watched domains and placing backorders.

How it works in the app: help article.

Scopes: Read with drop-catch.read. See Tokens and scopes.

Every endpoint below takes a token in the Authorization: Bearer header and answers JSON. Errors use the shared format in Errors. Base address: https://api.infranest.io/api.

Watched domains

List watched domains

Your watched domains, paginated with per_page (default 25, at most 200) and sorted with sort and dir. Filter with search, tag and flags such as active, available, registered, failed, paused and in_auction; meta carries counts per status.

GET/organizations/{organization}/watched-domains

Scope drop-catch.readRead only

Authorizationheader

Authorizationstringrequired

Bearer and your API token: Bearer $INFRANEST_TOKEN. See Tokens and scopes.

Path parameters

organizationintegerrequired

Your organization's ID: the number after /organizations/ in the app's address, or from GET /organizations.

Request

curl "https://api.infranest.io/api/organizations/42/watched-domains" \
  -H "Authorization: Bearer $INFRANEST_TOKEN" \
  -H "Accept: application/json"

powershell

$headers = @{
  Authorization = "Bearer $env:INFRANEST_TOKEN"
  Accept = "application/json"
}
Invoke-RestMethod -Method Get -Uri "https://api.infranest.io/api/organizations/42/watched-domains" -Headers $headers

php

<?php
// composer require guzzlehttp/guzzle
require "vendor/autoload.php";

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.infranest.io/api/organizations/42/watched-domains', [
    'headers' => [
        'Authorization' => 'Bearer ' . getenv('INFRANEST_TOKEN'),
        'Accept' => 'application/json',
    ],
]);

echo $response->getBody();

python

import os

import requests

response = requests.get(
    "https://api.infranest.io/api/organizations/42/watched-domains",
    headers={
        "Authorization": f"Bearer {os.environ['INFRANEST_TOKEN']}",
        "Accept": "application/json",
    },
)
response.raise_for_status()
print(response.json())

const response = await fetch('https://api.infranest.io/api/organizations/42/watched-domains', {
  headers: {
    Authorization: `Bearer ${process.env.INFRANEST_TOKEN}`,
    Accept: 'application/json',
  },
})
console.log(response.status, await response.text())

package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.infranest.io/api/organizations/42/watched-domains", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("INFRANEST_TOKEN"))
	req.Header.Set("Accept", "application/json")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status, string(out))
}

Response

json

{
  "current_page": 1,
  "data": [
    {
      "id": 3,
      "organization_id": 1,
      "name": "northwind",
      "tld": "app",
      "priority": 5,
      "status": "available",
      "auto_register": true,
      "registrar": null,
      "consecutive_available_count": 0,
      "notes": null,
      "last_checked_at": "2026-01-15T09:00:00.000000Z",
      "available_since": null,
      "registered_at": null,
      "deleted_at": null,
      "created_at": "2026-01-15T12:00:00.000000Z",
      "updated_at": "2026-01-15T12:00:00.000000Z",
      "next_check_at": "2026-01-15T13:00:00.000000Z",
      "observed_expires_at": null,
      "observed_status": null,
      "drop_eta": null,
      "date_visibility": null,
      "score": 88,
      "score_breakdown": null,
      "scored_at": "2026-01-15T12:00:00.000000Z",
      "registrar_preferences": null,
      "lifecycle_stage": "available",
      "observed_created_at": null,
      "contact_id": null,
      "extended_attributes": null,
      "catchability": 90,
      "catchability_signals": {
        "verdict": "available",
        "factors": []
      },
      "dns_signals": null,
      "observed_registrar": null,
      "observed_updated_at": null,
      "observed_nameservers": null,
      "lifecycle_progress": null,
      "http_signals": null,
      "enrichment_signals": null,
      "burst_until": null,
      "parallel_race": false,
      "in_auction": false,
      "auction": null,
      "backorder": false,
      "backorder_credential_id": null,
      "backorder_status": null,
      "whois_raw_at": null,
      "drop_eta_uncertainty_days": null,
      "lifecycle_source": null,
      "lifecycle_stage_since": "2026-01-10T12:00:00.000000Z",
      "published_drop_at": null,
      "deleted_at_registry": null,
      "dropping_soon_alerted_at": null,
      "last_successful_check_at": null,
      "consecutive_check_errors": 0,
      "check_failing_alerted_at": null,
      "funding": null,
      "funding_alerted_at": null,
      "full_name": "northwind.app",
      "drop_score": 5,
      "tags": []
    },
    {
      "id": 13,
      "organization_id": 1,
      "name": "northwind-app",
      "tld": "com",
      "priority": 5,
      "status": "failed",
      "auto_register": true,
      "registrar": null,
      "consecutive_available_count": 0,
      "notes": null,
      "last_checked_at": "2026-01-15T09:00:00.000000Z",
      "available_since": null,
      "registered_at": null,
      "deleted_at": null,
      "created_at": "2026-01-15T12:00:00.000000Z",
      "updated_at": "2026-01-15T12:00:00.000000Z",
      "next_check_at": "2026-01-15T13:00:00.000000Z",
      "observed_expires_at": null,
      "observed_status": null,
      "drop_eta": null,
      "date_visibility": null,
      "score": 87,
      "score_breakdown": null,
      "scored_at": "2026-01-15T12:00:00.000000Z",
      "registrar_preferences": null,
      "lifecycle_stage": "active",
      "observed_created_at": null,
      "contact_id": null,
      "extended_attributes": null,
      "catchability": 30,
      "catchability_signals": {
        "verdict": "active",
        "factors": []
      },
      "dns_signals": null,
      "observed_registrar": null,
      "observed_updated_at": null,
      "observed_nameservers": null,
      "lifecycle_progress": null,
      "http_signals": null,
      "enrichment_signals": null,
      "burst_until": null,
      "parallel_race": false,
      "in_auction": false,
      "auction": null,
      "backorder": false,
      "backorder_credential_id": null,
      "backorder_status": null,
      "whois_raw_at": null,
      "drop_eta_uncertainty_days": null,
      "lifecycle_source": null,
      "lifecycle_stage_since": "2026-01-09T12:00:00.000000Z",
      "published_drop_at": null,
      "deleted_at_registry": null,
      "dropping_soon_alerted_at": null,
      "last_successful_check_at": null,
      "consecutive_check_errors": 0,
      "check_failing_alerted_at": null,
      "funding": null,
      "funding_alerted_at": null,
      "full_name": "northwind-app.com",
      "drop_score": 5,
      "tags": []
    }
  ],
  "first_page_url": "http://localhost/api/organizations/1/watched-domains?page=1",
  "from": 1,
  "last_page": 1,
  "last_page_url": "http://localhost/api/organizations/1/watched-domains?page=1",
  "links": [
    {
      "url": null,
      "label": "&laquo; Previous",
      "page": null,
      "active": false
    },
    {
      "url": "http://localhost/api/organizations/1/watched-domains?page=1",
      "label": "1",
      "page": 1,
      "active": true
    }
  ],
  "next_page_url": null,
  "path": "http://localhost/api/organizations/1/watched-domains",
  "per_page": 25,
  "prev_page_url": null,
  "to": 16,
  "total": 16,
  "meta": {
    "counts": {
      "total": 16,
      "active": 13,
      "available": 2,
      "registered": 1,
      "failed": 1,
      "paused": 1,
      "in_auction": 1,
      "not_armed": 8
    },
    "tags": []
  }
}

json

{
  "code": "unauthenticated",
  "message": "You are not signed in, or the API token is missing, wrong, expired or revoked.",
  "hint": "Send a valid token in the Authorization header, as the word Bearer followed by the token. Create a new one under My account → Developer if it expired or was revoked.",
  "retryable": false,
  "docs_url": "https://developers.infranest.io/errors#unauthenticated",
  "reference": "k3j9x0b2qa"
}

json

{
  "code": "scope_missing",
  "message": "This API token does not have the drop-catch.read scope.",
  "hint": "Create a token that includes the scope named in \"required\". Give each token only the scopes it needs.",
  "retryable": false,
  "docs_url": "https://developers.infranest.io/errors#scope_missing",
  "required": "drop-catch.read",
  "reference": "k3j9x0b2qa"
}

json

{
  "code": "not_found",
  "message": "Nothing exists at this address, or you cannot see it.",
  "hint": "Check the IDs in the address. A resource in another organization answers as not found.",
  "retryable": false,
  "docs_url": "https://developers.infranest.io/errors#not_found",
  "reference": "k3j9x0b2qa"
}

json

{
  "code": "rate_limited",
  "message": "This token made more than 300 requests in a minute.",
  "hint": "Wait the number of seconds in \"retry_after\" (also the Retry-After header), then retry.",
  "retryable": true,
  "docs_url": "https://developers.infranest.io/errors#rate_limited",
  "limit_key": "api_requests_per_minute",
  "limit": 300,
  "retry_after": 12,
  "reference": "k3j9x0b2qa"
}

401 unauthenticated
403 scope_missing wrong_organization test_token_required test_token_sandbox_only permission_denied
404 not_found
429 rate_limited

Get a watched domain

One watched domain with its stored WHOIS record, lifecycle dates, estimated drop date, the check schedule still ahead and drop statistics for its extension.

GET/organizations/{organization}/watched-domains/{watchedDomain}

Scope drop-catch.readRead only

Authorizationheader

Authorizationstringrequired

Bearer and your API token: Bearer $INFRANEST_TOKEN. See Tokens and scopes.

Path parameters

organizationintegerrequired

Your organization's ID: the number after /organizations/ in the app's address, or from GET /organizations.

watchedDomainintegerrequired

The watched domain's ID.

Request

curl "https://api.infranest.io/api/organizations/42/watched-domains/1" \
  -H "Authorization: Bearer $INFRANEST_TOKEN" \
  -H "Accept: application/json"

powershell

$headers = @{
  Authorization = "Bearer $env:INFRANEST_TOKEN"
  Accept = "application/json"
}
Invoke-RestMethod -Method Get -Uri "https://api.infranest.io/api/organizations/42/watched-domains/1" -Headers $headers

php

<?php
// composer require guzzlehttp/guzzle
require "vendor/autoload.php";

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.infranest.io/api/organizations/42/watched-domains/1', [
    'headers' => [
        'Authorization' => 'Bearer ' . getenv('INFRANEST_TOKEN'),
        'Accept' => 'application/json',
    ],
]);

echo $response->getBody();

python

import os

import requests

response = requests.get(
    "https://api.infranest.io/api/organizations/42/watched-domains/1",
    headers={
        "Authorization": f"Bearer {os.environ['INFRANEST_TOKEN']}",
        "Accept": "application/json",
    },
)
response.raise_for_status()
print(response.json())

const response = await fetch('https://api.infranest.io/api/organizations/42/watched-domains/1', {
  headers: {
    Authorization: `Bearer ${process.env.INFRANEST_TOKEN}`,
    Accept: 'application/json',
  },
})
console.log(response.status, await response.text())

package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.infranest.io/api/organizations/42/watched-domains/1", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("INFRANEST_TOKEN"))
	req.Header.Set("Accept", "application/json")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status, string(out))
}

Response

json

{
  "id": 1,
  "organization_id": 1,
  "name": "northwind-labs",
  "tld": "com",
  "priority": 5,
  "status": "watching",
  "auto_register": false,
  "registrar": null,
  "consecutive_available_count": 0,
  "notes": null,
  "last_checked_at": "2026-01-15T09:00:00.000000Z",
  "available_since": null,
  "registered_at": null,
  "deleted_at": null,
  "created_at": "2026-01-15T12:00:00.000000Z",
  "updated_at": "2026-01-15T12:00:00.000000Z",
  "next_check_at": "2026-01-15T13:00:00.000000Z",
  "observed_expires_at": "2025-11-13T12:00:00.000000Z",
  "observed_status": null,
  "drop_eta": "2026-01-27T12:00:00.000000Z",
  "date_visibility": null,
  "score": 84,
  "score_breakdown": null,
  "scored_at": "2026-01-15T12:00:00.000000Z",
  "registrar_preferences": null,
  "lifecycle_stage": "redemption",
  "observed_created_at": null,
  "contact_id": null,
  "extended_attributes": null,
  "catchability": 78,
  "catchability_signals": {
    "verdict": "likely",
    "factors": []
  },
  "dns_signals": null,
  "observed_registrar": null,
  "observed_updated_at": null,
  "observed_nameservers": null,
  "lifecycle_progress": null,
  "http_signals": null,
  "enrichment_signals": null,
  "burst_until": null,
  "parallel_race": false,
  "in_auction": false,
  "auction": null,
  "backorder": false,
  "backorder_credential_id": null,
  "backorder_status": null,
  "whois_raw": null,
  "whois_raw_at": null,
  "drop_eta_uncertainty_days": null,
  "lifecycle_source": null,
  "lifecycle_stage_since": "2026-01-12T12:00:00.000000Z",
  "published_drop_at": null,
  "deleted_at_registry": null,
  "dropping_soon_alerted_at": null,
  "last_successful_check_at": null,
  "consecutive_check_errors": 0,
  "check_failing_alerted_at": null,
  "funding": null,
  "funding_alerted_at": null,
  "check_logs_count": 0,
  "registration_logs_count": 0,
  "full_name": "northwind-labs.com",
  "drop_score": 5,
  "tags": [],
  "drop_stats": {
    "heuristic": 78,
    "probability": null,
    "basis_n": 0,
    "scope": null,
    "phase": "redemption",
    "tld": "com"
  },
  "lifecycle_anchors": {
    "registered": null,
    "expired": "2025-11-13T12:00:00+00:00",
    "redemption": "2025-12-28T12:00:00+00:00",
    "pending_delete": "2026-01-27T12:00:00+00:00",
    "drop": "2026-02-01T12:00:00+00:00"
  },
  "measured_samples": null,
  "release": null,
  "cadence": [
    {
      "starts_at": null,
      "every_seconds": 21600
    },
    {
      "starts_at": "2026-01-25T12:00:00+00:00",
      "every_seconds": 3600
    }
  ]
}

json

{
  "code": "unauthenticated",
  "message": "You are not signed in, or the API token is missing, wrong, expired or revoked.",
  "hint": "Send a valid token in the Authorization header, as the word Bearer followed by the token. Create a new one under My account → Developer if it expired or was revoked.",
  "retryable": false,
  "docs_url": "https://developers.infranest.io/errors#unauthenticated",
  "reference": "k3j9x0b2qa"
}

json

{
  "code": "scope_missing",
  "message": "This API token does not have the drop-catch.read scope.",
  "hint": "Create a token that includes the scope named in \"required\". Give each token only the scopes it needs.",
  "retryable": false,
  "docs_url": "https://developers.infranest.io/errors#scope_missing",
  "required": "drop-catch.read",
  "reference": "k3j9x0b2qa"
}

json

{
  "code": "not_found",
  "message": "Nothing exists at this address, or you cannot see it.",
  "hint": "Check the IDs in the address. A resource in another organization answers as not found.",
  "retryable": false,
  "docs_url": "https://developers.infranest.io/errors#not_found",
  "reference": "k3j9x0b2qa"
}

json

{
  "code": "rate_limited",
  "message": "This token made more than 300 requests in a minute.",
  "hint": "Wait the number of seconds in \"retry_after\" (also the Retry-After header), then retry.",
  "retryable": true,
  "docs_url": "https://developers.infranest.io/errors#rate_limited",
  "limit_key": "api_requests_per_minute",
  "limit": 300,
  "retry_after": 12,
  "reference": "k3j9x0b2qa"
}

401 unauthenticated
403 scope_missing wrong_organization test_token_required test_token_sandbox_only permission_denied
404 not_found
429 rate_limited

List availability checks

Every availability check run on the watched domain, newest first, 100 per page. Filter with status.

GET/organizations/{organization}/watched-domains/{watchedDomain}/check-logs

Scope drop-catch.readRead only

Authorizationheader

Authorizationstringrequired

Bearer and your API token: Bearer $INFRANEST_TOKEN. See Tokens and scopes.

Path parameters

organizationintegerrequired

Your organization's ID: the number after /organizations/ in the app's address, or from GET /organizations.

watchedDomainintegerrequired

The watched domain's ID.

Request

curl "https://api.infranest.io/api/organizations/42/watched-domains/1/check-logs" \
  -H "Authorization: Bearer $INFRANEST_TOKEN" \
  -H "Accept: application/json"

powershell

$headers = @{
  Authorization = "Bearer $env:INFRANEST_TOKEN"
  Accept = "application/json"
}
Invoke-RestMethod -Method Get -Uri "https://api.infranest.io/api/organizations/42/watched-domains/1/check-logs" -Headers $headers

php

<?php
// composer require guzzlehttp/guzzle
require "vendor/autoload.php";

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.infranest.io/api/organizations/42/watched-domains/1/check-logs', [
    'headers' => [
        'Authorization' => 'Bearer ' . getenv('INFRANEST_TOKEN'),
        'Accept' => 'application/json',
    ],
]);

echo $response->getBody();

python

import os

import requests

response = requests.get(
    "https://api.infranest.io/api/organizations/42/watched-domains/1/check-logs",
    headers={
        "Authorization": f"Bearer {os.environ['INFRANEST_TOKEN']}",
        "Accept": "application/json",
    },
)
response.raise_for_status()
print(response.json())

const response = await fetch('https://api.infranest.io/api/organizations/42/watched-domains/1/check-logs', {
  headers: {
    Authorization: `Bearer ${process.env.INFRANEST_TOKEN}`,
    Accept: 'application/json',
  },
})
console.log(response.status, await response.text())

package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.infranest.io/api/organizations/42/watched-domains/1/check-logs", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("INFRANEST_TOKEN"))
	req.Header.Set("Accept", "application/json")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status, string(out))
}

Response

json

{
  "current_page": 1,
  "data": [],
  "first_page_url": "http://localhost/api/organizations/1/watched-domains/1/check-logs?page=1",
  "from": null,
  "last_page": 1,
  "last_page_url": "http://localhost/api/organizations/1/watched-domains/1/check-logs?page=1",
  "links": [
    {
      "url": null,
      "label": "&laquo; Previous",
      "page": null,
      "active": false
    },
    {
      "url": "http://localhost/api/organizations/1/watched-domains/1/check-logs?page=1",
      "label": "1",
      "page": 1,
      "active": true
    }
  ],
  "next_page_url": null,
  "path": "http://localhost/api/organizations/1/watched-domains/1/check-logs",
  "per_page": 100,
  "prev_page_url": null,
  "to": null,
  "total": 0
}

json

{
  "code": "unauthenticated",
  "message": "You are not signed in, or the API token is missing, wrong, expired or revoked.",
  "hint": "Send a valid token in the Authorization header, as the word Bearer followed by the token. Create a new one under My account → Developer if it expired or was revoked.",
  "retryable": false,
  "docs_url": "https://developers.infranest.io/errors#unauthenticated",
  "reference": "k3j9x0b2qa"
}

json

{
  "code": "scope_missing",
  "message": "This API token does not have the drop-catch.read scope.",
  "hint": "Create a token that includes the scope named in \"required\". Give each token only the scopes it needs.",
  "retryable": false,
  "docs_url": "https://developers.infranest.io/errors#scope_missing",
  "required": "drop-catch.read",
  "reference": "k3j9x0b2qa"
}

json

{
  "code": "not_found",
  "message": "Nothing exists at this address, or you cannot see it.",
  "hint": "Check the IDs in the address. A resource in another organization answers as not found.",
  "retryable": false,
  "docs_url": "https://developers.infranest.io/errors#not_found",
  "reference": "k3j9x0b2qa"
}

json

{
  "code": "rate_limited",
  "message": "This token made more than 300 requests in a minute.",
  "hint": "Wait the number of seconds in \"retry_after\" (also the Retry-After header), then retry.",
  "retryable": true,
  "docs_url": "https://developers.infranest.io/errors#rate_limited",
  "limit_key": "api_requests_per_minute",
  "limit": 300,
  "retry_after": 12,
  "reference": "k3j9x0b2qa"
}

401 unauthenticated
403 scope_missing wrong_organization test_token_required test_token_sandbox_only permission_denied
404 not_found
429 rate_limited

List registration attempts

Every attempt to register the watched domain, newest first, 50 per page.

GET/organizations/{organization}/watched-domains/{watchedDomain}/registration-logs

Scope drop-catch.readRead only

Authorizationheader

Authorizationstringrequired

Bearer and your API token: Bearer $INFRANEST_TOKEN. See Tokens and scopes.

Path parameters

organizationintegerrequired

Your organization's ID: the number after /organizations/ in the app's address, or from GET /organizations.

watchedDomainintegerrequired

The watched domain's ID.

Request

curl "https://api.infranest.io/api/organizations/42/watched-domains/1/registration-logs" \
  -H "Authorization: Bearer $INFRANEST_TOKEN" \
  -H "Accept: application/json"

powershell

$headers = @{
  Authorization = "Bearer $env:INFRANEST_TOKEN"
  Accept = "application/json"
}
Invoke-RestMethod -Method Get -Uri "https://api.infranest.io/api/organizations/42/watched-domains/1/registration-logs" -Headers $headers

php

<?php
// composer require guzzlehttp/guzzle
require "vendor/autoload.php";

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.infranest.io/api/organizations/42/watched-domains/1/registration-logs', [
    'headers' => [
        'Authorization' => 'Bearer ' . getenv('INFRANEST_TOKEN'),
        'Accept' => 'application/json',
    ],
]);

echo $response->getBody();

python

import os

import requests

response = requests.get(
    "https://api.infranest.io/api/organizations/42/watched-domains/1/registration-logs",
    headers={
        "Authorization": f"Bearer {os.environ['INFRANEST_TOKEN']}",
        "Accept": "application/json",
    },
)
response.raise_for_status()
print(response.json())

const response = await fetch('https://api.infranest.io/api/organizations/42/watched-domains/1/registration-logs', {
  headers: {
    Authorization: `Bearer ${process.env.INFRANEST_TOKEN}`,
    Accept: 'application/json',
  },
})
console.log(response.status, await response.text())

package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.infranest.io/api/organizations/42/watched-domains/1/registration-logs", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("INFRANEST_TOKEN"))
	req.Header.Set("Accept", "application/json")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status, string(out))
}

Response

json

{
  "current_page": 1,
  "data": [],
  "first_page_url": "http://localhost/api/organizations/1/watched-domains/1/registration-logs?page=1",
  "from": null,
  "last_page": 1,
  "last_page_url": "http://localhost/api/organizations/1/watched-domains/1/registration-logs?page=1",
  "links": [
    {
      "url": null,
      "label": "&laquo; Previous",
      "page": null,
      "active": false
    },
    {
      "url": "http://localhost/api/organizations/1/watched-domains/1/registration-logs?page=1",
      "label": "1",
      "page": 1,
      "active": true
    }
  ],
  "next_page_url": null,
  "path": "http://localhost/api/organizations/1/watched-domains/1/registration-logs",
  "per_page": 50,
  "prev_page_url": null,
  "to": null,
  "total": 0
}

json

{
  "code": "unauthenticated",
  "message": "You are not signed in, or the API token is missing, wrong, expired or revoked.",
  "hint": "Send a valid token in the Authorization header, as the word Bearer followed by the token. Create a new one under My account → Developer if it expired or was revoked.",
  "retryable": false,
  "docs_url": "https://developers.infranest.io/errors#unauthenticated",
  "reference": "k3j9x0b2qa"
}

json

{
  "code": "scope_missing",
  "message": "This API token does not have the drop-catch.read scope.",
  "hint": "Create a token that includes the scope named in \"required\". Give each token only the scopes it needs.",
  "retryable": false,
  "docs_url": "https://developers.infranest.io/errors#scope_missing",
  "required": "drop-catch.read",
  "reference": "k3j9x0b2qa"
}

json

{
  "code": "not_found",
  "message": "Nothing exists at this address, or you cannot see it.",
  "hint": "Check the IDs in the address. A resource in another organization answers as not found.",
  "retryable": false,
  "docs_url": "https://developers.infranest.io/errors#not_found",
  "reference": "k3j9x0b2qa"
}

json

{
  "code": "rate_limited",
  "message": "This token made more than 300 requests in a minute.",
  "hint": "Wait the number of seconds in \"retry_after\" (also the Retry-After header), then retry.",
  "retryable": true,
  "docs_url": "https://developers.infranest.io/errors#rate_limited",
  "limit_key": "api_requests_per_minute",
  "limit": 300,
  "retry_after": 12,
  "reference": "k3j9x0b2qa"
}

401 unauthenticated
403 scope_missing wrong_organization test_token_required test_token_sandbox_only permission_denied
404 not_found
429 rate_limited

List WHOIS changes

Changes detected in the watched domain’s WHOIS record, newest first, 50 per page.

GET/organizations/{organization}/watched-domains/{watchedDomain}/whois-changes

Scope drop-catch.readRead only

Authorizationheader

Authorizationstringrequired

Bearer and your API token: Bearer $INFRANEST_TOKEN. See Tokens and scopes.

Path parameters

organizationintegerrequired

Your organization's ID: the number after /organizations/ in the app's address, or from GET /organizations.

watchedDomainintegerrequired

The watched domain's ID.

Request

curl "https://api.infranest.io/api/organizations/42/watched-domains/1/whois-changes" \
  -H "Authorization: Bearer $INFRANEST_TOKEN" \
  -H "Accept: application/json"

powershell

$headers = @{
  Authorization = "Bearer $env:INFRANEST_TOKEN"
  Accept = "application/json"
}
Invoke-RestMethod -Method Get -Uri "https://api.infranest.io/api/organizations/42/watched-domains/1/whois-changes" -Headers $headers

php

<?php
// composer require guzzlehttp/guzzle
require "vendor/autoload.php";

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.infranest.io/api/organizations/42/watched-domains/1/whois-changes', [
    'headers' => [
        'Authorization' => 'Bearer ' . getenv('INFRANEST_TOKEN'),
        'Accept' => 'application/json',
    ],
]);

echo $response->getBody();

python

import os

import requests

response = requests.get(
    "https://api.infranest.io/api/organizations/42/watched-domains/1/whois-changes",
    headers={
        "Authorization": f"Bearer {os.environ['INFRANEST_TOKEN']}",
        "Accept": "application/json",
    },
)
response.raise_for_status()
print(response.json())

const response = await fetch('https://api.infranest.io/api/organizations/42/watched-domains/1/whois-changes', {
  headers: {
    Authorization: `Bearer ${process.env.INFRANEST_TOKEN}`,
    Accept: 'application/json',
  },
})
console.log(response.status, await response.text())

package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.infranest.io/api/organizations/42/watched-domains/1/whois-changes", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("INFRANEST_TOKEN"))
	req.Header.Set("Accept", "application/json")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status, string(out))
}

Response

json

{
  "current_page": 1,
  "data": [
    {
      "id": 1,
      "watched_domain_id": 1,
      "field": "status",
      "old_value": "clientTransferProhibited",
      "new_value": "redemptionPeriod",
      "changed_at": "2026-01-11T12:00:00.000000Z"
    },
    {
      "id": 2,
      "watched_domain_id": 1,
      "field": "expiry",
      "old_value": "2026-08-14",
      "new_value": "2026-08-14",
      "changed_at": "2025-12-20T12:00:00.000000Z"
    }
  ],
  "first_page_url": "http://localhost/api/organizations/1/watched-domains/1/whois-changes?page=1",
  "from": 1,
  "last_page": 1,
  "last_page_url": "http://localhost/api/organizations/1/watched-domains/1/whois-changes?page=1",
  "links": [
    {
      "url": null,
      "label": "&laquo; Previous",
      "page": null,
      "active": false
    },
    {
      "url": "http://localhost/api/organizations/1/watched-domains/1/whois-changes?page=1",
      "label": "1",
      "page": 1,
      "active": true
    }
  ],
  "next_page_url": null,
  "path": "http://localhost/api/organizations/1/watched-domains/1/whois-changes",
  "per_page": 50,
  "prev_page_url": null,
  "to": 3,
  "total": 3
}

json

{
  "code": "unauthenticated",
  "message": "You are not signed in, or the API token is missing, wrong, expired or revoked.",
  "hint": "Send a valid token in the Authorization header, as the word Bearer followed by the token. Create a new one under My account → Developer if it expired or was revoked.",
  "retryable": false,
  "docs_url": "https://developers.infranest.io/errors#unauthenticated",
  "reference": "k3j9x0b2qa"
}

json

{
  "code": "scope_missing",
  "message": "This API token does not have the drop-catch.read scope.",
  "hint": "Create a token that includes the scope named in \"required\". Give each token only the scopes it needs.",
  "retryable": false,
  "docs_url": "https://developers.infranest.io/errors#scope_missing",
  "required": "drop-catch.read",
  "reference": "k3j9x0b2qa"
}

json

{
  "code": "not_found",
  "message": "Nothing exists at this address, or you cannot see it.",
  "hint": "Check the IDs in the address. A resource in another organization answers as not found.",
  "retryable": false,
  "docs_url": "https://developers.infranest.io/errors#not_found",
  "reference": "k3j9x0b2qa"
}

json

{
  "code": "rate_limited",
  "message": "This token made more than 300 requests in a minute.",
  "hint": "Wait the number of seconds in \"retry_after\" (also the Retry-After header), then retry.",
  "retryable": true,
  "docs_url": "https://developers.infranest.io/errors#rate_limited",
  "limit_key": "api_requests_per_minute",
  "limit": 300,
  "retry_after": 12,
  "reference": "k3j9x0b2qa"
}

401 unauthenticated
403 scope_missing wrong_organization test_token_required test_token_sandbox_only permission_denied
404 not_found
429 rate_limited

Check whether you already hold a domain

The domain in your organization matching name and tld (both required) that you hold or are registering, or null when there is none.

GET/organizations/{organization}/watched-domains/held

Scope drop-catch.readRead only

Authorizationheader

Authorizationstringrequired

Bearer and your API token: Bearer $INFRANEST_TOKEN. See Tokens and scopes.

Path parameters

organizationintegerrequired

Your organization's ID: the number after /organizations/ in the app's address, or from GET /organizations.

Query parameters

namestringrequired

Must not be greater than 63 characters.

tldstringrequired

Must not be greater than 63 characters.

Request

curl "https://api.infranest.io/api/organizations/42/watched-domains/held?name=www&tld=%3Ctld%3E" \
  -H "Authorization: Bearer $INFRANEST_TOKEN" \
  -H "Accept: application/json"

powershell

$headers = @{
  Authorization = "Bearer $env:INFRANEST_TOKEN"
  Accept = "application/json"
}
Invoke-RestMethod -Method Get -Uri "https://api.infranest.io/api/organizations/42/watched-domains/held?name=www&tld=%3Ctld%3E" -Headers $headers

php

<?php
// composer require guzzlehttp/guzzle
require "vendor/autoload.php";

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.infranest.io/api/organizations/42/watched-domains/held?name=www&tld=%3Ctld%3E', [
    'headers' => [
        'Authorization' => 'Bearer ' . getenv('INFRANEST_TOKEN'),
        'Accept' => 'application/json',
    ],
]);

echo $response->getBody();

python

import os

import requests

response = requests.get(
    "https://api.infranest.io/api/organizations/42/watched-domains/held?name=www&tld=%3Ctld%3E",
    headers={
        "Authorization": f"Bearer {os.environ['INFRANEST_TOKEN']}",
        "Accept": "application/json",
    },
)
response.raise_for_status()
print(response.json())

const response = await fetch('https://api.infranest.io/api/organizations/42/watched-domains/held?name=www&tld=%3Ctld%3E', {
  headers: {
    Authorization: `Bearer ${process.env.INFRANEST_TOKEN}`,
    Accept: 'application/json',
  },
})
console.log(response.status, await response.text())

package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.infranest.io/api/organizations/42/watched-domains/held?name=www&tld=%3Ctld%3E", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("INFRANEST_TOKEN"))
	req.Header.Set("Accept", "application/json")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status, string(out))
}

Response

json

{
  "domain": {
    "id": 1,
    "full_name": "northwind.com",
    "status": "active",
    "tenure": "held",
    "registrar": "Namecheap",
    "expires_at": "2026-02-02T00:00:00+00:00",
    "auto_renew": true
  }
}

json

{
  "code": "unauthenticated",
  "message": "You are not signed in, or the API token is missing, wrong, expired or revoked.",
  "hint": "Send a valid token in the Authorization header, as the word Bearer followed by the token. Create a new one under My account → Developer if it expired or was revoked.",
  "retryable": false,
  "docs_url": "https://developers.infranest.io/errors#unauthenticated",
  "reference": "k3j9x0b2qa"
}

json

{
  "code": "scope_missing",
  "message": "This API token does not have the drop-catch.read scope.",
  "hint": "Create a token that includes the scope named in \"required\". Give each token only the scopes it needs.",
  "retryable": false,
  "docs_url": "https://developers.infranest.io/errors#scope_missing",
  "required": "drop-catch.read",
  "reference": "k3j9x0b2qa"
}

json

{
  "code": "not_found",
  "message": "Nothing exists at this address, or you cannot see it.",
  "hint": "Check the IDs in the address. A resource in another organization answers as not found.",
  "retryable": false,
  "docs_url": "https://developers.infranest.io/errors#not_found",
  "reference": "k3j9x0b2qa"
}

json

{
  "code": "rate_limited",
  "message": "This token made more than 300 requests in a minute.",
  "hint": "Wait the number of seconds in \"retry_after\" (also the Retry-After header), then retry.",
  "retryable": true,
  "docs_url": "https://developers.infranest.io/errors#rate_limited",
  "limit_key": "api_requests_per_minute",
  "limit": 300,
  "retry_after": 12,
  "reference": "k3j9x0b2qa"
}

401 unauthenticated
403 scope_missing wrong_organization test_token_required test_token_sandbox_only permission_denied
404 not_found
429 rate_limited

List registrars for an extension

The connected registrar accounts that can register a caught domain. With tld, each says whether it carries that extension and what it charges, and requirements lists what the extension asks of a registrant, or null when nothing is on file.

GET/organizations/{organization}/watched-domains/registrars

Scope drop-catch.readRead only

Authorizationheader

Authorizationstringrequired

Bearer and your API token: Bearer $INFRANEST_TOKEN. See Tokens and scopes.

Path parameters

organizationintegerrequired

Your organization's ID: the number after /organizations/ in the app's address, or from GET /organizations.

Request

curl "https://api.infranest.io/api/organizations/42/watched-domains/registrars" \
  -H "Authorization: Bearer $INFRANEST_TOKEN" \
  -H "Accept: application/json"

powershell

$headers = @{
  Authorization = "Bearer $env:INFRANEST_TOKEN"
  Accept = "application/json"
}
Invoke-RestMethod -Method Get -Uri "https://api.infranest.io/api/organizations/42/watched-domains/registrars" -Headers $headers

php

<?php
// composer require guzzlehttp/guzzle
require "vendor/autoload.php";

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.infranest.io/api/organizations/42/watched-domains/registrars', [
    'headers' => [
        'Authorization' => 'Bearer ' . getenv('INFRANEST_TOKEN'),
        'Accept' => 'application/json',
    ],
]);

echo $response->getBody();

python

import os

import requests

response = requests.get(
    "https://api.infranest.io/api/organizations/42/watched-domains/registrars",
    headers={
        "Authorization": f"Bearer {os.environ['INFRANEST_TOKEN']}",
        "Accept": "application/json",
    },
)
response.raise_for_status()
print(response.json())

const response = await fetch('https://api.infranest.io/api/organizations/42/watched-domains/registrars', {
  headers: {
    Authorization: `Bearer ${process.env.INFRANEST_TOKEN}`,
    Accept: 'application/json',
  },
})
console.log(response.status, await response.text())

package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.infranest.io/api/organizations/42/watched-domains/registrars", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("INFRANEST_TOKEN"))
	req.Header.Set("Accept", "application/json")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status, string(out))
}

Response

json

{
  "registrars": [
    {
      "credential_id": 2,
      "provider": "cloudflare",
      "provider_name": "Cloudflare",
      "provider_label": "Cloudflare DNS",
      "supports_tld": null,
      "price": null,
      "can_race": false
    },
    {
      "credential_id": 3,
      "provider": "namecheap",
      "provider_name": "Namecheap",
      "provider_label": "Namecheap Registrar",
      "supports_tld": null,
      "price": null,
      "can_race": false
    }
  ],
  "requirements": null
}

json

{
  "code": "unauthenticated",
  "message": "You are not signed in, or the API token is missing, wrong, expired or revoked.",
  "hint": "Send a valid token in the Authorization header, as the word Bearer followed by the token. Create a new one under My account → Developer if it expired or was revoked.",
  "retryable": false,
  "docs_url": "https://developers.infranest.io/errors#unauthenticated",
  "reference": "k3j9x0b2qa"
}

json

{
  "code": "scope_missing",
  "message": "This API token does not have the drop-catch.read scope.",
  "hint": "Create a token that includes the scope named in \"required\". Give each token only the scopes it needs.",
  "retryable": false,
  "docs_url": "https://developers.infranest.io/errors#scope_missing",
  "required": "drop-catch.read",
  "reference": "k3j9x0b2qa"
}

json

{
  "code": "not_found",
  "message": "Nothing exists at this address, or you cannot see it.",
  "hint": "Check the IDs in the address. A resource in another organization answers as not found.",
  "retryable": false,
  "docs_url": "https://developers.infranest.io/errors#not_found",
  "reference": "k3j9x0b2qa"
}

json

{
  "code": "rate_limited",
  "message": "This token made more than 300 requests in a minute.",
  "hint": "Wait the number of seconds in \"retry_after\" (also the Retry-After header), then retry.",
  "retryable": true,
  "docs_url": "https://developers.infranest.io/errors#rate_limited",
  "limit_key": "api_requests_per_minute",
  "limit": 300,
  "retry_after": 12,
  "reference": "k3j9x0b2qa"
}

401 unauthenticated
403 scope_missing wrong_organization test_token_required test_token_sandbox_only permission_denied
404 not_found
429 rate_limited

List registrars available for catching

The connected registrar accounts that can register a caught domain, by name, and whether each may race for it. Makes no calls to the registrars.

GET/organizations/{organization}/watched-domains/registrars/identities

Scope drop-catch.readRead only

Authorizationheader

Authorizationstringrequired

Bearer and your API token: Bearer $INFRANEST_TOKEN. See Tokens and scopes.

Path parameters

organizationintegerrequired

Your organization's ID: the number after /organizations/ in the app's address, or from GET /organizations.

Request

curl "https://api.infranest.io/api/organizations/42/watched-domains/registrars/identities" \
  -H "Authorization: Bearer $INFRANEST_TOKEN" \
  -H "Accept: application/json"

powershell

$headers = @{
  Authorization = "Bearer $env:INFRANEST_TOKEN"
  Accept = "application/json"
}
Invoke-RestMethod -Method Get -Uri "https://api.infranest.io/api/organizations/42/watched-domains/registrars/identities" -Headers $headers

php

<?php
// composer require guzzlehttp/guzzle
require "vendor/autoload.php";

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.infranest.io/api/organizations/42/watched-domains/registrars/identities', [
    'headers' => [
        'Authorization' => 'Bearer ' . getenv('INFRANEST_TOKEN'),
        'Accept' => 'application/json',
    ],
]);

echo $response->getBody();

python

import os

import requests

response = requests.get(
    "https://api.infranest.io/api/organizations/42/watched-domains/registrars/identities",
    headers={
        "Authorization": f"Bearer {os.environ['INFRANEST_TOKEN']}",
        "Accept": "application/json",
    },
)
response.raise_for_status()
print(response.json())

const response = await fetch('https://api.infranest.io/api/organizations/42/watched-domains/registrars/identities', {
  headers: {
    Authorization: `Bearer ${process.env.INFRANEST_TOKEN}`,
    Accept: 'application/json',
  },
})
console.log(response.status, await response.text())

package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.infranest.io/api/organizations/42/watched-domains/registrars/identities", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("INFRANEST_TOKEN"))
	req.Header.Set("Accept", "application/json")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status, string(out))
}

Response

json

{
  "registrars": [
    {
      "credential_id": 2,
      "provider": "cloudflare",
      "provider_name": "Cloudflare",
      "provider_label": "Cloudflare DNS",
      "can_race": false
    },
    {
      "credential_id": 3,
      "provider": "namecheap",
      "provider_name": "Namecheap",
      "provider_label": "Namecheap Registrar",
      "can_race": false
    }
  ]
}

json

{
  "code": "unauthenticated",
  "message": "You are not signed in, or the API token is missing, wrong, expired or revoked.",
  "hint": "Send a valid token in the Authorization header, as the word Bearer followed by the token. Create a new one under My account → Developer if it expired or was revoked.",
  "retryable": false,
  "docs_url": "https://developers.infranest.io/errors#unauthenticated",
  "reference": "k3j9x0b2qa"
}

json

{
  "code": "scope_missing",
  "message": "This API token does not have the drop-catch.read scope.",
  "hint": "Create a token that includes the scope named in \"required\". Give each token only the scopes it needs.",
  "retryable": false,
  "docs_url": "https://developers.infranest.io/errors#scope_missing",
  "required": "drop-catch.read",
  "reference": "k3j9x0b2qa"
}

json

{
  "code": "not_found",
  "message": "Nothing exists at this address, or you cannot see it.",
  "hint": "Check the IDs in the address. A resource in another organization answers as not found.",
  "retryable": false,
  "docs_url": "https://developers.infranest.io/errors#not_found",
  "reference": "k3j9x0b2qa"
}

json

{
  "code": "rate_limited",
  "message": "This token made more than 300 requests in a minute.",
  "hint": "Wait the number of seconds in \"retry_after\" (also the Retry-After header), then retry.",
  "retryable": true,
  "docs_url": "https://developers.infranest.io/errors#rate_limited",
  "limit_key": "api_requests_per_minute",
  "limit": 300,
  "retry_after": 12,
  "reference": "k3j9x0b2qa"
}

401 unauthenticated
403 scope_missing wrong_organization test_token_required test_token_sandbox_only permission_denied
404 not_found
429 rate_limited

Whois servers

List custom WHOIS servers

The WHOIS servers you set per extension to use instead of the default ones, sorted by extension.

GET/organizations/{organization}/whois-servers

Scope drop-catch.readRead only

Authorizationheader

Authorizationstringrequired

Bearer and your API token: Bearer $INFRANEST_TOKEN. See Tokens and scopes.

Path parameters

organizationintegerrequired

Your organization's ID: the number after /organizations/ in the app's address, or from GET /organizations.

Request

curl "https://api.infranest.io/api/organizations/42/whois-servers" \
  -H "Authorization: Bearer $INFRANEST_TOKEN" \
  -H "Accept: application/json"

powershell

$headers = @{
  Authorization = "Bearer $env:INFRANEST_TOKEN"
  Accept = "application/json"
}
Invoke-RestMethod -Method Get -Uri "https://api.infranest.io/api/organizations/42/whois-servers" -Headers $headers

php

<?php
// composer require guzzlehttp/guzzle
require "vendor/autoload.php";

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.infranest.io/api/organizations/42/whois-servers', [
    'headers' => [
        'Authorization' => 'Bearer ' . getenv('INFRANEST_TOKEN'),
        'Accept' => 'application/json',
    ],
]);

echo $response->getBody();

python

import os

import requests

response = requests.get(
    "https://api.infranest.io/api/organizations/42/whois-servers",
    headers={
        "Authorization": f"Bearer {os.environ['INFRANEST_TOKEN']}",
        "Accept": "application/json",
    },
)
response.raise_for_status()
print(response.json())

const response = await fetch('https://api.infranest.io/api/organizations/42/whois-servers', {
  headers: {
    Authorization: `Bearer ${process.env.INFRANEST_TOKEN}`,
    Accept: 'application/json',
  },
})
console.log(response.status, await response.text())

package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.infranest.io/api/organizations/42/whois-servers", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("INFRANEST_TOKEN"))
	req.Header.Set("Accept", "application/json")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status, string(out))
}

Response

json

[
  {
    "id": 1,
    "organization_id": 1,
    "tld": "dev",
    "server": "whois.nic.google",
    "note": "Override for .dev lookups.",
    "created_at": "2026-01-15T12:00:00.000000Z",
    "updated_at": "2026-01-15T12:00:00.000000Z"
  }
]

json

{
  "code": "unauthenticated",
  "message": "You are not signed in, or the API token is missing, wrong, expired or revoked.",
  "hint": "Send a valid token in the Authorization header, as the word Bearer followed by the token. Create a new one under My account → Developer if it expired or was revoked.",
  "retryable": false,
  "docs_url": "https://developers.infranest.io/errors#unauthenticated",
  "reference": "k3j9x0b2qa"
}

json

{
  "code": "scope_missing",
  "message": "This API token does not have the drop-catch.read scope.",
  "hint": "Create a token that includes the scope named in \"required\". Give each token only the scopes it needs.",
  "retryable": false,
  "docs_url": "https://developers.infranest.io/errors#scope_missing",
  "required": "drop-catch.read",
  "reference": "k3j9x0b2qa"
}

json

{
  "code": "not_found",
  "message": "Nothing exists at this address, or you cannot see it.",
  "hint": "Check the IDs in the address. A resource in another organization answers as not found.",
  "retryable": false,
  "docs_url": "https://developers.infranest.io/errors#not_found",
  "reference": "k3j9x0b2qa"
}

json

{
  "code": "rate_limited",
  "message": "This token made more than 300 requests in a minute.",
  "hint": "Wait the number of seconds in \"retry_after\" (also the Retry-After header), then retry.",
  "retryable": true,
  "docs_url": "https://developers.infranest.io/errors#rate_limited",
  "limit_key": "api_requests_per_minute",
  "limit": 300,
  "retry_after": 12,
  "reference": "k3j9x0b2qa"
}

401 unauthenticated
403 scope_missing wrong_organization test_token_required test_token_sandbox_only permission_denied
404 not_found
429 rate_limited

Drop catch ​

Watched domains ​

List watched domains ​

Get a watched domain ​

List availability checks ​

List registration attempts ​

List WHOIS changes ​

Check whether you already hold a domain ​

List registrars for an extension ​

List registrars available for catching ​

Whois servers ​

List custom WHOIS servers ​

Drop catch

Watched domains

List watched domains

Get a watched domain

List availability checks

List registration attempts

List WHOIS changes

Check whether you already hold a domain

List registrars for an extension

List registrars available for catching

Whois servers

List custom WHOIS servers