# Get an entity record

`GET /v3/entities/{id}`

> Tag: Entity Record

Returns the full record for an entity: the identity core plus enrichment, meaning
firmographics, classification labels, operational footprint and social profiles.

This endpoint never blocks. It serves what exists now and reports the build state in
`enrichment.status`. If the record has never been enriched, the first read starts the
build in the background; poll until `enrichment.status` is `complete`.

If the ID was merged into another entity, `status` is `merged`, `merged_into` carries the
canonical ID, and the body is the canonical entity. Store the new ID.

## Request

### Path parameters

- `id` (string, required) — A `siq_` entity ID. Legal-entity (`le_`) and operational-presence (`op_`) IDs are not accepted.

### Example request

```bash
curl --request GET \
  --url 'https://api.savvyiq.ai/v3/entities/siq_33d67jj0wJESjEdFHMhuQ' \
  --header 'apikey: YOUR_API_KEY'
```

## Responses

### 200 — The entity record.

- `status` (string (enum))
- `merged_into` (string) — Set when `status` is `merged`. Store this ID instead of the one you asked for.
- `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)
      - `street_address` (string)
      - `street_number` (string)
      - `sub_premise` (string)
      - `city` (string)
      - `state` (string) — Subdivision as written ("California"), when we hold it.
      - `state_code` (string) — ISO-3166-2 subdivision code ("CA"). Derived from `state` when we can map it confidently; `null` rather than guessed when we cannot.
      - `postal_code` (string)
      - `country` (string)
      - `country_code` (string)
      - `formatted_address` (string) — Single-line rendering of the parts above. Composed from them when we hold no stored formatting.
  - `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.
      - `id` (integer)
      - `code` (string)
      - `name` (string)
      - `organization` (string)
      - `jurisdiction` (string)
      - `country_code` (string)
      - `website` (string)
  - `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.
  - `facets` (object) — Ownership and legal form, not industry. Industry codes live under `industry.schemes`.
    - `sector` (string (enum))
    - `legal_form` (string (enum))
  - `industry` (object) — Industry codes keyed by scheme. A scheme that was not classified is absent; an empty key is never returned.
    - `schemes` (object)
      - `naics_2022` (array<object>)
      - `sic` (array<object>)
  - `parent_entity` (object)
    - `name` (string)
  - `type` (string (enum))
  - `subtype` (string)
  - `attributes` (object) — Firmographics. Every field is nullable until enrichment fills it.
    - `description` (string)
    - `website` (string)
    - `domain` (string)
    - `employee_count` (integer)
    - `employee_range` (string)
    - `revenue` (integer)
    - `revenue_range` (string)
    - `founding_date` (string)
    - `stock_ticker` (string)
    - `exchange` (string)
    - `is_public` (boolean)
    - `market_cap` (integer)
    - `funding_total_usd` (integer)
    - `funding_rounds_count` (integer)
  - `classification` (object) — Human-readable labels and the controlled business-model axes. Numeric industry codes live under `industry.schemes`, not here.
    - `sector` (string)
    - `industry` (string)
    - `sub_industry` (string)
    - `business_tags` (array<string>)
    - `market_segments` (array<string (enum)>) — Most-material-first, max 2. `b2b2c` never appears with `b2b` or `b2c`.
    - `revenue_models` (array<string (enum)>) — Most-material-first, max 3.
    - `products_services` (array<string>)
  - `operational_presence` (array<object>) — Where the entity operates, one entry per country.
    - `id` (string)
    - `country_code` (string)
    - `country` (string)
    - `count` (integer) — Registrations known in that country.
    - `is_home_jurisdiction` (boolean)
  - `social_profiles` (object)
    - `linkedin` (object)
      - `handle` (string)
    - `facebook` (object)
      - `handle` (string)
    - `crunchbase` (object)
      - `handle` (string)
- `enrichment` (object) — Build state of the record. Omitted entirely if the lifecycle could not be read; treat an absent block as unknown, not as failed.
  - `status` (string (enum))
  - `updated_at` (string <date-time>)
- `request_id` (string)

```json
{
  "status": "matched",
  "merged_into": null,
  "entity": {
    "id": "siq_33d67jj0wJESjEdFHMhuQ",
    "status": "active",
    "description": "Datadog is a leading cloud monitoring and security platform that provides AI-powered observability solutions for cloud-scale applications. Its SaaS-based data analytics platform enables businesses to gain comprehensive visibility into their entire technology stack, from infrastructure to applications, helping DevOps teams prevent downtime, resolve performance issues, and ensure optimal user experience.",
    "headquarters": {
      "address": {
        "street_address": "620 8th Ave, 45th Floor",
        "street_number": null,
        "sub_premise": null,
        "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"
      }
    },
    "website": "https://www.datadoghq.com/",
    "primary_legal_entity": {
      "id": "le_2Zp3Yy6S7O6Btccq56WOH",
      "jurisdiction": "US-DE",
      "state_code": "DE",
      "country_code": "US",
      "registration_authority": {
        "id": 1024,
        "code": "RA000602",
        "name": "Division of Corporations, Department of State",
        "organization": "Division of Corporations, Department of State",
        "jurisdiction": "Delaware",
        "country_code": "US",
        "website": "https://corp.delaware.gov/"
      }
    },
    "identifiers": [
      {
        "type": "registration_id",
        "value": "4832851",
        "jurisdiction": "US-DE"
      },
      {
        "type": "cik",
        "value": "0001561550",
        "jurisdiction": null
      },
      {
        "type": "lei",
        "value": "549300F6JNO0KRPO1K63",
        "jurisdiction": null
      }
    ],
    "matching_branch": null,
    "type": "business",
    "subtype": "incorporated_entity",
    "attributes": {
      "domain": "datadoghq.com",
      "employee_count": 3001,
      "employee_range": "1K-5K",
      "revenue": 3672030976,
      "revenue_range": "$1B-$10B",
      "founding_date": "2010-01-01",
      "stock_ticker": "DDOG",
      "exchange": "NASDAQ",
      "is_public": true,
      "market_cap": 91027922944,
      "funding_total_usd": null,
      "funding_rounds_count": 10
    },
    "classification": {
      "sector": "Technology",
      "industry": "Computer Software",
      "sub_industry": "Cloud Software",
      "business_tags": [
        "Cloud Monitoring",
        "Observability",
        "SaaS",
        "AIOps",
        "Application Performance Monitoring",
        "Cloud Security",
        "IT Infrastructure Monitoring",
        "DevOps Tools"
      ],
      "market_segments": [
        "b2b"
      ],
      "revenue_models": [
        "subscription"
      ],
      "products_services": [
        "Infrastructure Monitoring",
        "Application Performance Monitoring (APM)",
        "Log Management",
        "Cloud Security",
        "Digital Experience Monitoring",
        "Network Performance Monitoring"
      ]
    },
    "operational_presence": [
      {
        "id": "op_33ZbC5x7TWMqjRnGBE88L",
        "country_code": "US",
        "country": "United States of America",
        "count": 4,
        "is_home_jurisdiction": true
      }
    ],
    "social_profiles": {
      "crunchbase": {
        "handle": "datadog"
      },
      "linkedin": {
        "handle": "company/datadog"
      },
      "facebook": {
        "handle": "datadoghq"
      }
    },
    "facets": {
      "sector": "public",
      "legal_form": "corporation"
    },
    "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
          }
        ],
        "sic": [
          {
            "code": "7372",
            "label": "Prepackaged Software",
            "is_primary": true,
            "confidence": 95
          }
        ]
      }
    },
    "legal_name": "DATADOG, INC.",
    "display_name": "Datadog"
  },
  "request_id": "req_344u0qy2y3M8aaO9EGfL4",
  "enrichment": {
    "status": "complete",
    "updated_at": "2026-07-31T19:22:05.042Z"
  }
}
```

### 400 — Malformed ID, or an ID that is not a `siq_` entity ID.

- `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": "Invalid entity id prefix 'LEGAL_ENTITY_'. Expected 'MASTER_ENTITY_'."
  }
}
```

### 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"
  }
}
```

### 404 — No entity with that ID.

- `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"
  }
}
```

### 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"
  }
}
```