Developer Reference

Due Diligence Recipe API Documentation

Due Diligence Recipe API Documentation: Complete domain acquisition analysis with RDAP data, valuation, health checks, and brand protection insights.

Due Diligence Recipe

Complete domain acquisition analysis with RDAP data, valuation, health checks, and brand protection insights.

GET /v1/recipes/due-diligence

Query Parameters

Parameter	Type	Description
domain required	string	Domain to analyze

Response Includes

RDAP registration data (registrar, dates, nameservers)
Domain valuation estimate
Health check results
Reputation analysis
Pricing comparison across registrars

Response Fields

Field	Type
`success`	boolean
`data`	object
`data.domain`	string
`data.summary`	object
`data.summary.recommendation`	string
`data.summary.confidence_score`	number
`data.summary.key_findings[]`	string[]
`data.summary.risk_factors[]`	string[]
`data.registration`	object
`data.registration.registrar`	string
`data.registration.created_date`	string
`data.registration.expiry_date`	string
`data.registration.updated_date`	string
`data.registration.age_years`	number
`data.registration.days_until_expiry`	number
`data.registration.status[]`	string[]
`data.registration.nameservers[]`	string[]
`data.registration.dnssec`	boolean
`data.registration.privacy_protected`	boolean
`data.valuation`	object
`data.valuation.estimate_low`	number
`data.valuation.estimate_mid`	number
`data.valuation.estimate_high`	number
`data.valuation.currency`	string
`data.valuation.confidence`	number
`data.valuation.factors`	object
`data.valuation.factors.length`	number
`data.valuation.factors.tld`	string
`data.valuation.factors.brandability`	number
`data.health`	object
`data.health.score`	number
`data.health.grade`	string
`data.health.dns_configured`	boolean
`data.health.ssl_valid`	boolean
`data.health.email_deliverable`	boolean
`data.health.warnings[]`	string[]
`data.security`	object
`data.security.reputation_score`	number
`data.security.reputation_grade`	string
`data.security.risk_level`	string
`data.security.blacklisted`	boolean
`data.security.blacklist_details[]`	array
`data.brand_protection`	object
`data.brand_protection.typo_score`	number
`data.brand_protection.typo_grade`	string
`data.brand_protection.variants_registered`	number
`data.brand_protection.high_risk_variants`	number
`data.pricing`	object
`data.pricing.best_price`	number
`data.pricing.best_registrar`	string
`data.pricing.all_prices[]`	object[]
`data.pricing.all_prices[]`	object
`data.pricing.all_prices[].registrar`	string
`data.pricing.all_prices[].price`	number
`data.pricing.all_prices[].currency`	string
`data.action_items[]`	object[]
`data.action_items[]`	object
`data.action_items[].priority`	string
`data.action_items[].category`	string
`data.action_items[].action`	string
`data.action_items[].details`	string
`data.action_items[].estimated_impact`	string
`meta`	object
`meta.recipe_name`	string
`meta.credits_used`	number
`meta.credits_saved`	number
`meta.duration_ms`	number
`meta.components_called[]`	string[]
`meta.cached_components[]`	string[]
`meta.timestamp`	string
`errors[]`	array

Example Response

{
  "success": true,
  "data": {
    "domain": "example.com",
    "summary": {
      "recommendation": "buy",
      "confidence_score": 88,
      "key_findings": [
        "Established registration history",
        "Clean reputation"
      ],
      "risk_factors": [
        "DNSSEC not enabled"
      ]
    },
    "registration": {
      "registrar": "Example Registrar",
      "created_date": "2019-03-11",
      "expiry_date": "2027-03-11",
      "updated_date": "2026-03-10",
      "age_years": 7,
      "days_until_expiry": 330,
      "status": [
        "active",
        "clientTransferProhibited"
      ],
      "nameservers": [
        "ns1.example.net",
        "ns2.example.net"
      ],
      "dnssec": false,
      "privacy_protected": true
    },
    "valuation": {
      "estimate_low": 1800,
      "estimate_mid": 3500,
      "estimate_high": 5200,
      "currency": "USD",
      "confidence": 0.72,
      "factors": {
        "length": 11,
        "tld": "com",
        "brandability": 0.81
      }
    },
    "health": {
      "score": 84,
      "grade": "A",
      "dns_configured": true,
      "ssl_valid": true,
      "email_deliverable": true,
      "warnings": [
        "DNSSEC not enabled"
      ]
    },
    "security": {
      "reputation_score": 91,
      "reputation_grade": "A",
      "risk_level": "low",
      "blacklisted": false,
      "blacklist_details": []
    },
    "brand_protection": {
      "typo_score": 78,
      "typo_grade": "B",
      "variants_registered": 2,
      "high_risk_variants": 1
    },
    "pricing": {
      "best_price": 9.99,
      "best_registrar": "cloudflare",
      "all_prices": [
        {
          "registrar": "cloudflare",
          "price": 9.99,
          "currency": "USD"
        }
      ]
    },
    "action_items": [
      {
        "priority": "medium",
        "category": "security",
        "action": "Enable DNSSEC",
        "details": "Improve zone integrity for resolvers.",
        "estimated_impact": "Lower spoofing risk"
      }
    ]
  },
  "meta": {
    "recipe_name": "domain-due-diligence",
    "credits_used": 10,
    "credits_saved": 8,
    "duration_ms": 742,
    "components_called": [
      "availability",
      "whois",
      "valuation",
      "health",
      "reputation",
      "typosquatting",
      "pricing"
    ],
    "cached_components": [
      "pricing"
    ],
    "timestamp": "2026-04-15T09:30:00Z"
  },
  "errors": []
}