Agent Harbor Domain Verify API

openapi: 3.2.0
info:
  title: Agent Harbor x402 Gateway Domain Verify API
  version: 1.0.0
  x-guidance: 'Pay-per-call business website data for agents. Every paid operation takes one bare domain (e.g. example.com). Call it unpaid to get HTTP 402 with the price; pay with x402 (USDC on Base, PAYMENT-SIGNATURE header) or, where offered, MPP (WWW-Authenticate: Payment, Tempo USDC) and retry. Failed or unusable calls are never charged. Cheapest first: /company, then /scrape; /enrich and /audit are the deeper tiers. Free: /catalog, /llms.txt, /SKILL.md, /.well-known/x402. Public-data routes (SEC EDGAR, recalls, package check, domain verification, PDF) take the query parameters listed in their own entries instead of a domain.'
  contact:
    name: Agent Harbor LLC
    email: anchor@agentharbor.agency
    url: https://agentharbor.agency
tags:
- name: Domain Verify
paths:
  /domain-verify:
    get:
      summary: Data Domain Verify
      operationId: data_domain_verify_domain_verify_get
      responses:
        '200':
          description: Served and charged.
          content:
            application/json:
              schema: {}
              example:
                product: domain_verify
                tier: domain-verify
                price_paid_usdc: 0.005
                data:
                  domain: mailchimp.com
                  summary:
                    resolves: true
                    registered: true
                    age_days: 9238
                    website_ok: true
                    tls_valid: true
                    email_configured: true
                  risk_flags: []
                  dns:
                    nxdomain: false
                    a:
                    - 23.45.72.90
                    aaaa: []
                    mx:
                    - priority: 5
                      host: mx1.intuit.iphmx.com
                    - priority: 5
                      host: mx2.intuit.iphmx.com
                    ns:
                    - a5-65.akam.net
                    - a4-65.akam.net
                    spf: v=spf1 ip4:205.201.128.0/20 ip4:198.2.128.0/18 ip4:148.105.0.0/16 ip4:129.145.74.12 include:_spf.google.com include:mailsenders.netsuite.com include:_spf2.intuit.com include:_spf.qualtrics.com ip4:199.33.145.1 ip4:199.33.145.32 ip4:35.176.132.251 ip4:52.60.115.116 ~all
                    dmarc_policy: reject
                    caa:
                    - 0 issue "amazonaws.com"
                    - 0 issue "pki.goog"
                    resolves: true
                    dnssec_validated: false
                  registration:
                    found: true
                    registered_name: mailchimp.com
                    registrar: MarkMonitor Inc.
                    registrar_iana_id: '292'
                    created: '2001-06-29'
                    expires: '2029-06-29'
                    updated: '2024-06-21'
                    age_days: 9238
                    days_to_expiry: 988
                    status:
                    - client delete prohibited
                    - client transfer prohibited
                    nameservers:
                    - a1-205.akam.net
                    - a14-66.akam.net
                    dnssec_signed: false
                    rdap_server: rdap.verisign.com
                  tls:
                    checked: true
                    valid: true
                    issuer: DigiCert Inc
                    not_before: '2026-01-09'
                    not_after: '2027-01-16'
                    days_to_expiry: 93
                    covers_domain: true
                    san_count: 1
                    protocol: TLSv1.3
                  http:
                    checked: true
                    ok: true
                    status: 200
                    final_url: https://mailchimp.com/
                    final_host: mailchimp.com
                    https: true
                    hsts: true
                    server: istio-envoy
                    redirects: []
                  attribution: DNS via Cloudflare 1.1.1.1 DNS-over-HTTPS; registration data via RDAP from the registry named in rdap_server (IANA bootstrap); TLS and HTTP checked directly by Agent Harbor.
                provider: Agent Harbor — public-data service
        '402':
          description: 'Payment required: x402 v2 PAYMENT-REQUIRED challenge (price, network, payTo).'
        '422':
          description: Invalid input, not found, or nothing usable to sell. Not charged.
        '502':
          description: Upstream failure. Not charged.
      description: 'Given a domain, tells whether it is a real, live and established business domain: DNS (A, MX, NS, SPF, DMARC, DNSSEC), registration from RDAP (registrar, created and expiry dates, age, status; never registrant contacts), the TLS certificate (valid, issuer, expiry) and the website (final URL, status, HSTS), with risk flags such as newly registered, no MX or invalid TLS. ''Does not exist'' is an answer. Not charged if lookups fail.'
      x-payment-info:
        protocol: x402
        version: 2
        scheme: exact
        network: eip155:8453
        asset: USDC
        price_usd: '0.005'
        payTo: '0x840C829530DF7B4CCF700Fa3A0060cF2C80b014e'
        price:
          mode: fixed
          currency: USD
          amount: '0.005'
        protocols:
        - x402:
            version: 2
            scheme: exact
            network: eip155:8453
            asset: USDC
            amount: '5000'
            payTo: '0x840C829530DF7B4CCF700Fa3A0060cF2C80b014e'
      parameters:
      - name: domain
        in: query
        required: true
        schema:
          type: string
          maxLength: 253
          pattern: ^[A-Za-z0-9]([A-Za-z0-9-]{0,61}[A-Za-z0-9])?(\.[A-Za-z0-9]([A-Za-z0-9-]{0,61}[A-Za-z0-9])?)+$
          example: mailchimp.com
        description: Bare hostname, e.g. example.com
      tags:
      - Domain Verify