Entity Record

Get an entity record

GET /v3/entities/{id}

View as markdown Open in ChatGPT Open in Claude

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.

Path parameters

idstring required
A siq_ entity ID. Legal-entity (le_) and operational-presence (op_) IDs are not accepted.

Responses

200 The entity record.

statusstring (enum)
matchedmerged
merged_intostring
Set when status is merged. Store this ID instead of the one you asked for.
entityobject
Show 19 nested fieldsHide nested fields
- idstring
- display_namestring
  The brand or common name.
- legal_namestring
  The registered name, as it appears on the government record.
- statusstring (enum)
  activeinactive
- descriptionstring
- websitestring
- headquartersobject
  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.
  Show 1 nested fieldHide nested fields
  addressobject
  Show 10 nested fieldsHide nested fields
  street_addressstring
  street_numberstring
  sub_premisestring
  citystring
  statestring
  Subdivision as written ("California"), when we hold it.
  state_codestring
  ISO-3166-2 subdivision code ("CA"). Derived from state when we can map it confidently; null rather than guessed when we cannot.
  postal_codestring
  countrystring
  country_codestring
  formatted_addressstring
  Single-line rendering of the parts above. Composed from them when we hold no stored formatting.
- primary_legal_entityobject
  The government registration that anchors this entity.
  Show 5 nested fieldsHide nested fields
  idstring
  jurisdictionstring
  country_codestring
  state_codestring
  registration_authorityobject
  The government register this entity is recorded in.
  Show 7 nested fieldsHide nested fields
  idinteger
  codestring
  namestring
  organizationstring
  jurisdictionstring
  country_codestring
  websitestring
- identifiersarray<object>
  Typed external identifiers, in a stable order.
  Show 3 nested fieldsHide nested fields
  typestring (enum)
  registration_idciksec_cikleibiceindunsticker
  valuestring
  Canonicalized for its type on the resolution and record endpoints. See Codes & enums.
  jurisdictionstring
  ISO jurisdiction, where the identifier type is jurisdictional. Absent entirely on /v3/domain-intelligence.
- matching_branchobject
  Set when the query matched a specific branch or foreign registration rather than the entity's home registration.
- facetsobject
  Ownership and legal form, not industry. Industry codes live under industry.schemes.
  Show 2 nested fieldsHide nested fields
  sectorstring (enum)
  privatepublicgovernmentnonprofit
  legal_formstring (enum)
  Show 16 possible valuesHide possible values
  llccorporationc_corps_corplpllpgpsole_proprietorshipnonprofit_corppllcpccooperativemunicipal_agencygovernment_entitytrustunknown
- industryobject
  Industry codes keyed by scheme. A scheme that was not classified is absent; an empty key is never returned.
  Show 1 nested fieldHide nested fields
  schemesobject
  Show 2 nested fieldsHide nested fields
  naics_2022array<object>
  Show 4 nested fieldsHide nested fields
  codestring
  labelstring
  is_primaryboolean
  One code per scheme is primary. Primary codes are returned first.
  confidenceinteger
  sicarray<object>
  Show 4 nested fieldsHide nested fields
  codestring
  labelstring
  is_primaryboolean
  One code per scheme is primary. Primary codes are returned first.
  confidenceinteger
- parent_entityobject
  Show 1 nested fieldHide nested fields
  namestring
- typestring (enum)
  businessnonprofitgovernmentpersonotherunknown
- subtypestring
- attributesobject
  Firmographics. Every field is nullable until enrichment fills it.
  Show 14 nested fieldsHide nested fields
  descriptionstring
  websitestring
  domainstring
  employee_countinteger
  employee_rangestring
  revenueinteger
  revenue_rangestring
  founding_datestring
  stock_tickerstring
  exchangestring
  is_publicboolean
  market_capinteger
  funding_total_usdinteger
  funding_rounds_countinteger
- classificationobject
  Human-readable labels and the controlled business-model axes. Numeric industry codes live under industry.schemes, not here.
  Show 7 nested fieldsHide nested fields
  sectorstring
  industrystring
  sub_industrystring
  business_tagsarray<string>
  market_segmentsarray<string (enum)>
  Most-material-first, max 2. b2b2c never appears with b2b or b2c.
  revenue_modelsarray<string (enum)>
  Most-material-first, max 3.
  products_servicesarray<string>
- operational_presencearray<object>
  Where the entity operates, one entry per country.
  Show 5 nested fieldsHide nested fields
  idstring
  country_codestring
  countrystring
  countinteger
  Registrations known in that country.
  is_home_jurisdictionboolean
- social_profilesobject
  Show 3 nested fieldsHide nested fields
  linkedinobject
  Show 1 nested fieldHide nested fields
  handlestring
  facebookobject
  Show 1 nested fieldHide nested fields
  handlestring
  crunchbaseobject
  Show 1 nested fieldHide nested fields
  handlestring
enrichmentobject
Build state of the record. Omitted entirely if the lifecycle could not be read; treat an absent block as unknown, not as failed.
Show 2 nested fieldsHide nested fields
- statusstring (enum)
  pendingbuildingrefreshingcompletefailed
- updated_atstring <date-time>
request_idstring

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

errorobject
Show 2 nested fieldsHide nested fields
- typestring
  Stable, machine-readable error code.
- messagestring
  Human-readable explanation. Do not match on this.

401 Missing or invalid API key.

errorobject
Show 2 nested fieldsHide nested fields
- typestring
  Stable, machine-readable error code.
- messagestring
  Human-readable explanation. Do not match on this.

404 No entity with that ID.

errorobject
Show 2 nested fieldsHide nested fields
- typestring
  Stable, machine-readable error code.
- messagestring
  Human-readable explanation. Do not match on this.

429 Rate limit exceeded.

errorobject
Show 2 nested fieldsHide nested fields
- typestring
  Stable, machine-readable error code.
- messagestring
  Human-readable explanation. Do not match on this.

500 Something went wrong on our side.

errorobject
Show 2 nested fieldsHide nested fields
- typestring
  Stable, machine-readable error code.
- messagestring
  Human-readable explanation. Do not match on this.

Example request

cURL

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

Example response

The full record for the resolved entity200

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