# Resolve a domain

`GET /v3/domain-intelligence`

> Tag: Domain Intelligence

Resolves a domain to the business behind it and describes the domain itself: what kind of
site it is, how it relates to that business, its industry breakdown, reachability, and
social profiles.

Synchronous, and **always returns `200`**. Check the top-level `status`. `complete` means
`data` is populated. `building` and `pending` mean research is still running and `data` is
`null`, so call again shortly.

Also accepts `POST` with the same parameters as a JSON body.

## Request

### Query parameters

- `domain` (string, required) — A domain, a full URL, or an email address. All are normalized to the root domain, so `https://www.datadoghq.com/pricing`, `datadoghq.com` and `jane@datadoghq.com` are equivalent.

### Example request

```bash
curl --request GET \
  --url 'https://api.savvyiq.ai/v3/domain-intelligence?domain=value' \
  --header 'apikey: YOUR_API_KEY'
```

## Responses

### 200 — Always returned, including while research is still running. Check `status`.

- `domain` (string) — The normalized root domain.
- `status` (string (enum)) — `complete` means `data` is populated. `building` and `pending` mean research is still running and `data` is `null`.
- `message` (string)
- `request_id` (string)
- `metadata` (object)
  - `last_updated` (string <date-time>)
  - `processing_started_at` (string <date-time>)
  - `estimated_completion` (string <date-time>)
- `data` (object) — Null until `status` is `complete`.
  - `status` (string (enum))
  - `confidence` (integer)
  - `type` (string)
  - `subtype` (string)
  - `entity` (object)
    - `id` (string)
    - `display_name` (string) — The brand or common name.
    - `legal_name` (string) — The registered name, as it appears on the government record.
    - `status` (string (enum))
    - `description` (string)
    - `website` (string)
    - `headquarters` (object) — The headquarters address, always as the nested `address` object — there are no flat alias fields. Every key below is always present; unknown values are `null` rather than omitted, so the key set is stable across responses and endpoints.
      - `address` (object)
    - `primary_legal_entity` (object) — The government registration that anchors this entity.
      - `id` (string)
      - `jurisdiction` (string)
      - `country_code` (string)
      - `state_code` (string)
      - `registration_authority` (object) — The government register this entity is recorded in.
    - `identifiers` (array<object>) — Typed external identifiers, in a stable order.
      - `type` (string (enum))
      - `value` (string) — Canonicalized for its type on the resolution and record endpoints. See [Codes & enums](#codes-enums).
      - `jurisdiction` (string) — ISO jurisdiction, where the identifier type is jurisdictional. Absent entirely on `/v3/domain-intelligence`.
    - `matching_branch` (object) — Set when the query matched a specific branch or foreign registration rather than the entity's home registration.
  - `candidate` (object) — Our best hypothesis when an entity could not be confirmed. A response populates `entity` or `candidate`, never both.
    - `name` (string)
    - `legal_name` (string)
    - `jurisdiction` (string)
    - `status` (string)
    - `description` (string)
    - `primary_address` (object)
      - `full_address` (string)
      - `state_code` (string)
      - `country_code` (string)
  - `factors` (array<object>)
    - `code` (string) — Stable code. See [Codes & enums](#codes-enums).
    - `type` (string (enum))
    - `description` (string)
    - `impact` (string)
  - `actions` (array<object>)
    - `code` (string)
    - `description` (string)
  - `domain_intelligence` (object) — What we know about the domain itself, as distinct from the company behind it.
    - `domain` (string)
    - `url` (string)
    - `domain_aliases` (array<string>)
    - `description` (string)
    - `tranco_rank` (integer) — Global traffic rank. Lower is bigger.
    - `website_status` (object) — Reachability of the domain when we last checked it.
      - `status` (integer) — HTTP status code observed.
      - `is_resolvable` (boolean)
      - `is_webserver_responsive` (boolean)
      - `has_content` (boolean)
      - `failure_reason` (string)
      - `last_checked` (string <date-time>)
    - `domain_context` (object) — What this domain is, and how it relates to the business behind it.
      - `domain_type` (string (enum))
      - `domain_relationship` (string (enum))
      - `domain_purpose` (string)
      - `business_relevance` (string)
    - `is_disposable_email_provider` (boolean)
    - `industry` (object) — Industry codes keyed by scheme. A scheme that was not classified is absent; an empty key is never returned.
      - `schemes` (object)
    - `classification` (object) — Scoped to this domain's observable motion, which can legitimately differ from the whole company's. Compare with `classification` on `/v3/entities/{id}`.
      - `sector` (string)
      - `industry` (string)
      - `sub_industry` (string)
      - `business_tags` (array<string>)
      - `market_segments` (array<string (enum)>)
      - `revenue_models` (array<string>)
      - `products_services` (array<string>)
    - `social_profiles` (object) — The accounts this site links to. Same `{handle}` shape as the entity record, so one parser reads both. The entity record's set is the entity's best-known handles; this set is what the domain itself advertises, and the two can differ.
      - `linkedin` (object)
      - `facebook` (object)
      - `crunchbase` (object)
      - `twitter` (object)
  - `redirect_info` (object) — Present only when the requested domain redirected elsewhere.
    - `is_redirect` (boolean)
    - `original_domain` (string)
    - `final_domain` (string)
    - `redirect_status_code` (integer)
    - `redirect_type` (string)

```json
{
  "domain": "datadoghq.com",
  "status": "complete",
  "data": {
    "status": "matched",
    "confidence": 98,
    "type": "business",
    "subtype": "incorporated_entity",
    "entity": {
      "id": "siq_33d67jj0wJESjEdFHMhuQ",
      "display_name": "Datadog",
      "legal_name": "Datadog, Inc.",
      "status": "active",
      "description": "Datadog, Inc. is an American company that provides an AI-powered observability and security platform for cloud-scale applications. Its SaaS-based data analytics platform enables businesses to monitor servers, containers, databases, and third-party services, offering solutions for infrastructure monitoring, application performance monitoring, log management, and cloud security. The platform helps DevOps teams prevent downtime, resolve performance issues, and ensure optimal user experience by making their entire technology stack observable.",
      "website": "https://www.datadoghq.com/",
      "headquarters": {
        "address": {
          "street_address": "620 8th Ave, 45th Floor",
          "street_number": "620",
          "sub_premise": "45th Floor",
          "city": "New York",
          "state": "New York",
          "state_code": "NY",
          "postal_code": "10018",
          "country": "United States",
          "country_code": "US",
          "formatted_address": "620 8th Ave, 45th Floor, New York, New York 10018, United States"
        }
      },
      "primary_legal_entity": {
        "id": "le_33ZaMFuXb9ypDhieUu9ld",
        "jurisdiction": "US-NV",
        "state_code": "NV",
        "country_code": "US"
      },
      "identifiers": [
        {
          "type": "registration_id",
          "value": "NV20263564978",
          "jurisdiction": "US-NV"
        },
        {
          "type": "cik",
          "value": "0001561550",
          "jurisdiction": null
        },
        {
          "type": "lei",
          "value": "549300F6JNO0KRPO1K63",
          "jurisdiction": null
        },
        {
          "type": "ticker",
          "value": "DDOG",
          "jurisdiction": null
        }
      ],
      "matching_branch": null
    },
    "candidate": null,
    "factors": [
      {
        "code": "website_official_status",
        "type": "strength",
        "impact": "Confirms this is the entity's official website.",
        "description": "The domain 'datadoghq.com' clearly functions as the official website for Datadog."
      },
      {
        "code": "legal_entity_confirmed_on_website",
        "type": "strength",
        "impact": "Confirms the legal entity operating this domain.",
        "description": "The legal entity 'DATADOG, INC.' is identified and confirmed within the domain's legal information."
      },
      {
        "code": "domain_content_matches_entity",
        "type": "strength",
        "impact": "Confirms this is the entity's official domain.",
        "description": "Domain content, branding, and services on 'datadoghq.com' strongly align with Datadog's operations."
      },
      {
        "code": "consistent_entity_references",
        "type": "strength",
        "impact": "Eliminates ambiguity about domain ownership.",
        "description": "Multiple pages across 'datadoghq.com' consistently reference Datadog and its corporate identity."
      }
    ],
    "actions": [],
    "domain_intelligence": {
      "domain": "datadoghq.com",
      "url": "https://www.datadoghq.com/",
      "domain_aliases": [],
      "description": "Datadog, Inc. is an American technology company that provides a cloud monitoring and analytics platform. Its core business involves offering software solutions for infrastructure monitoring, application performance management, log management, and security monitoring. The company helps businesses gain comprehensive visibility into their cloud applications and IT environments, enabling them to optimize performance, enhance security, and manage costs.",
      "tranco_rank": 739,
      "website_status": {
        "status": 200,
        "is_resolvable": true,
        "is_webserver_responsive": true,
        "has_content": true,
        "failure_reason": null,
        "last_checked": "2026-08-27T21:11:59.190Z"
      },
      "social_profiles": {
        "linkedin": {
          "handle": "company/datadog"
        },
        "facebook": {
          "handle": null
        },
        "crunchbase": {
          "handle": null
        },
        "twitter": {
          "handle": "datadoghq"
        }
      },
      "classification": {
        "sector": "Technology",
        "industry": "Software & Services",
        "sub_industry": "Enterprise Software",
        "market_segments": [
          "b2b"
        ],
        "revenue_models": [
          "subscription",
          "usage_based"
        ],
        "products_services": [
          "Infrastructure Monitoring",
          "Application Performance Monitoring (APM)",
          "Log Management",
          "Security Monitoring",
          "Real User Monitoring (RUM)",
          "Synthetic Monitoring",
          "Cloud Cost Management",
          "AI Integrations"
        ],
        "business_tags": [
          "Cloud Monitoring",
          "Observability Platform",
          "DevOps Tools",
          "IT Operations Management",
          "Performance Management",
          "Security Analytics",
          "SaaS",
          "Data Analytics",
          "Cloud Computing",
          "AI-powered Monitoring"
        ]
      },
      "domain_context": {
        "domain_type": "corporate_website",
        "domain_relationship": "direct_owner",
        "domain_purpose": "The primary online presence for Datadog, Inc., used for marketing products, providing customer support, and corporate communications.",
        "business_relevance": "This domain is central to Datadog's business operations, serving as the main channel for customer engagement, product information dissemination, and brand identity."
      },
      "is_disposable_email_provider": false,
      "industry": {
        "schemes": {
          "naics_2022": [
            {
              "code": "513210",
              "label": "Software Publishers",
              "is_primary": true,
              "confidence": 95
            },
            {
              "code": "541511",
              "label": "Custom Computer Programming Services",
              "is_primary": false,
              "confidence": 80
            },
            {
              "code": "51",
              "label": "Information",
              "is_primary": false,
              "confidence": 90
            }
          ]
        }
      }
    }
  },
  "message": null,
  "metadata": {
    "last_updated": "2026-08-20T18:43:39.219Z",
    "processing_started_at": null,
    "estimated_completion": null
  }
}
```

### 400 — Invalid or missing parameters.

- `error` (object)
  - `type` (string) — Stable, machine-readable error code.
  - `message` (string) — Human-readable explanation. Do not match on this.

```json
{
  "error": {
    "type": "bad_request",
    "message": "Name is required"
  }
}
```

### 401 — Missing or invalid API key.

- `error` (object)
  - `type` (string) — Stable, machine-readable error code.
  - `message` (string) — Human-readable explanation. Do not match on this.

```json
{
  "error": {
    "type": "string",
    "message": "string"
  }
}
```

### 402 — Credit balance exhausted.

- `error` (object)
  - `type` (string) — Stable, machine-readable error code.
  - `message` (string) — Human-readable explanation. Do not match on this.

```json
{
  "error": {
    "type": "insufficient_credits",
    "message": "Insufficient credits"
  }
}
```

### 403 — This account is not enabled for the v3 API.

- `error` (object)
  - `type` (string) — Stable, machine-readable error code.
  - `message` (string) — Human-readable explanation. Do not match on this.

```json
{
  "error": {
    "type": "no_pricing_configured",
    "message": "No pricing configured for this API"
  }
}
```

### 429 — Rate limit exceeded.

- `error` (object)
  - `type` (string) — Stable, machine-readable error code.
  - `message` (string) — Human-readable explanation. Do not match on this.

```json
{
  "error": {
    "type": "string",
    "message": "string"
  }
}
```

### 500 — Something went wrong on our side.

- `error` (object)
  - `type` (string) — Stable, machine-readable error code.
  - `message` (string) — Human-readable explanation. Do not match on this.

```json
{
  "error": {
    "type": "string",
    "message": "string"
  }
}
```