Domain age and registration lookup from public RDAP

Domain age and registration lookup from public RDAP: registration, expiry and last-changed dates, age in days, registrar, registry status flags and nameservers for a domain. Use it to spot newly registered or expiring domains before trusting a link, sender or vendor. Uncharged when the registry cannot be reached. $0.003 USDC per call on Base.

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

POST https://api.avedaris.com/v1/paid/domain-rdap-lookup

Our checks, last 30 days

Example input (from the provider)

{
  "body": {
    "domain": "example.com"
  },
  "bodyType": "json",
  "method": "POST",
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "additionalProperties": false,
          "properties": {
            "domain": {
              "description": "Domain to look up, e.g. example.com. An email address or URL is also accepted and reduced to its domain. 3 to 253 characters.",
              "maxLength": 253,
              "minLength": 3,
              "type": "string"
            }
          },
          "required": [
            "domain"
          ],
          "type": "object"
        },
        "bodyType": {
          "enum": [
            "json",
            "form-data",
            "text"
          ],
          "type": "string"
        },
        "method": {
          "enum": [
            "POST"
          ],
          "type": "string"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method",
        "bodyType",
        "body"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "result": {
              "description": "Output of domain.rdap_lookup. The fields below are the documented core; some responses add further detail fields.",
              "properties": {
                "ageDays": {
                  "description": "Whole days since registration, or null when the date is unknown.",
                  "type": "integer"
                },
                "daysUntilExpiry": {
                  "description": "Whole days until expiry (negative if already past), or null.",
                  "type": "integer"
                },
                "domain": {
                  "description": "Domain that was checked, lowercased, with any www. prefix, email local part or URL path removed.",
                  "type": "string"
                },
                "expirationDate": {
                  "description": "ISO 8601 date the current registration expires, or null.",
                  "type": "string"
                },
                "flags": {
                  "description": "Plain-language warning codes: registered_under_30_days, registered_under_180_days, expires_within_30_days, registry_hold_or_deletion_status, registration_date_not_published, not_found_in_registry, tld_has_no_public_rdap.",
                  "type": "array"
                },
                "found": {
                  "description": "true when the registry returned a record for the domain.",
                  "type": "boolean"
                },
                "lastChangedDate": {
                  "description": "ISO 8601 date the registry record last changed, or null.",
                  "type": "string"
                },
                "nameservers": {
                  "description": "Delegated nameserver hostnames from the registry, lowercased.",
                  "items": {
                    "description": "Delegated nameserver hostnames from the registry, lowercased.",
                    "type": "string"
                  },
                  "type": "array"
                },
                "queriedDomain": {
                  "description": "Name the registry answered for; a parent domain when a subdomain was sent.",
                  "type": "string"
                },
                "registrar": {
                  "description": "Sponsoring registrar name from RDAP, or null.",
                  "type": "string"
                },
                "registrationDate": {
                  "description": "ISO 8601 registration (creation) date from RDAP, or null when not published.",
                  "type": "string"
                },
                "source": {
                  "description": "Always rdap: data comes from the public RDAP registry service for the TLD.",
                  "type": "string"
                },
                "status": {
                  "description": "Registry status flags in lowercase, e.g. client transfer prohibited, server hold.",
                  "items": {
                    "description": "Registry status flags in lowercase, e.g. client transfer prohibited, server hold.",
                    "type": "string"
                  },
                  "type": "array"
                }
              },
              "required": [
                "domain",
                "queriedDomain",
                "found",
                "registrationDate",
                "expirationDate",
                "lastChangedDate",
                "ageDays",
                "daysUntilExpiry",
                "registrar",
                "status",
                "nameservers",
                "flags",
                "source"
              ],
              "type": "object"
            }
          },
          "required": [
            "result"
          ],
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}

This page as JSON