API Documentation

Endpoint

Response schema

interface DomainLookup {
  // Registry-derived fields below are omitted when available is true.
  id?:               string;
  domain:            string;
  available:         boolean;
  ldhName?:          string | null;
  unicodeName?:      string | null;
  handle?:           string | null;
  rdapServer?:       string | null;
  secureDNS?:        boolean | null;
  delegationSigned?: boolean | null;
  lookedUpAt?:       string; // ISO 8601
  entities:          Entity[];
  nameservers:       Nameserver[];
  statuses:          string[];
  events:            Event[];
}

interface Entity {
  role:         string;
  handle:       string | null;
  name:         string | null;
  organization: string | null;
  ianaId:       string | null;
  abuseEmail:   string | null;
  abusePhone:   string | null;
}

interface Nameserver {
  ldhName: string;
  ipv4:    string[];
  ipv6:    string[];
}

interface Event {
  eventAction: string;
  eventDate:   string | null; // ISO 8601
}

When available is true (the domain is unregistered), the response contains only domain, available, and the four arrays. The registry-derived fields (id, ldhName, unicodeName, handle, rdapServer, secureDNS, delegationSigned, lookedUpAt) are omitted.

Code examples

# Anonymous (rate-limited)
curl https://api.domain-sentinel.com/v1/lookup/github.com

# With API key (unlimited)
curl -H "Authorization: Bearer ds_your_api_key" \
  https://api.domain-sentinel.com/v1/lookup/github.com

Rate limiting

Anonymous requests are rate-limited by IP address. Authenticate with an API key to remove the limit.

The 429 response body includes a retryAfter timestamp (Unix ms).

HTTP status codes

Authentication

Create a free API key in your dashboard. Pass it in the Authorization header as a Bearer token. Keys can have an optional expiry date and can be revoked at any time.

FAQ