# Get entity data by entity ID

`GET /v1/entities/{entity_id}`

> Tag: Business intelligence

Retrieve complete entity data using the stable entity ID returned from entity resolution.

**Performance & Accuracy:** This endpoint prioritizes data accuracy and completeness over speed. For entities not yet in our system, initial processing may take 2-5 minutes as we comprehensively gather and verify information from multiple authoritative sources (business registries, financial databases, etc.). Entities already in our database typically return within seconds. As our database grows, more entities will have instant responses.

This endpoint provides immediate responses with different statuses based on data availability:

- **building**: Initial data compilation is in progress. No data available yet. You should poll this endpoint.
- **complete**: Entity data is complete and current. Data is available and fresh.
- **refreshing**: Previously compiled data is available but a refresh is in progress. You get immediate access to current data while new data is being prepared.

For building and refreshing states, clients should poll this endpoint periodically (recommended interval: 5-10 seconds) until the status becomes "complete".

This design allows multiple customers to efficiently poll the same entity without creating duplicate processing jobs.

## Request

### Path parameters

- `entity_id` (string, required) — The stable entity ID returned from entity resolution (e.g., "siq_2ZYEAh7VdPkWsvlsqW9lG")

### Example request

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

## Responses

### 200 — OK

- `entity_id` (string, required) — The stable entity ID that was requested
- `status` (string (enum), required) — The current status of the entity data: * `building` - Initial data compilation is in progress, no data available yet * `complete` - Entity data is complete and current, data is available * `refreshing` - Previously compiled data is available but being refreshed
- `data` (object) — The complete entity data (present when status is "complete" or "refreshing")
  - `id` (string) — The stable entity ID
  - `name` (string) — The entity name
  - `type` (string (enum)) — The entity type
  - `subtype` (string (enum)) — The entity subtype
  - `status` (string (enum)) — The entity status
  - `headquarters` (object)
    - `address` (object)
      - `city` (string)
      - `state` (string)
      - `country` (string)
      - `state_code` (string)
      - `postal_code` (string)
      - `sub_premise` (string)
      - `country_code` (string)
      - `street_number` (string)
      - `street_address` (string)
      - `formatted_address` (string)
  - `primary_legal_entity` (object)
    - `id` (string)
    - `name` (string)
    - `jurisdiction` (object)
      - `country_code` (string)
      - `state_province` (string)
  - `attributes` (object)
    - `description` (string)
    - `website` (string)
    - `domain` (string)
    - `employee_count` (integer) — Total employee count
    - `employee_range` (string) — Human-readable employee range bucket
    - `revenue` (integer) — Annual revenue in USD
    - `revenue_range` (string) — Human-readable revenue range bucket
    - `founding_date` (string <date>) — Date the company was founded (YYYY-MM-DD)
    - `stock_ticker` (string) — Stock ticker symbol
    - `exchange` (string) — Stock exchange where the entity is listed
    - `is_public` (boolean) — Whether the entity is publicly traded
    - `market_cap` (integer) — Market capitalization in USD
    - `funding_total_usd` (integer) — Total funding raised in USD
    - `funding_rounds_count` (integer) — Number of funding rounds
  - `social_profiles` (object) — Social media and professional profile handles for the entity
    - `crunchbase` (object)
      - `handle` (string)
    - `linkedin` (object)
      - `handle` (string)
    - `facebook` (object)
      - `handle` (string)
    - `twitter` (object)
      - `handle` (string)
  - `classification` (object)
    - `naics_codes_2022` (array<object>)
      - `code` (string)
      - `name` (string)
      - `relevance` (integer)
      - `confidence` (integer)
      - `is_primary` (boolean)
    - `sic_codes` (array<object>) — Standard Industrial Classification codes
      - `code` (string)
      - `name` (string)
      - `relevance` (integer)
      - `confidence` (integer)
      - `is_primary` (boolean)
    - `business_tags` (array<string>)
    - `business_model` (array<string>) — **Deprecated.** Free-text business-model labels — not a controlled vocabulary, so the values vary between records and between refreshes of the same record, and a single string mixes market segment, revenue model, sales channel and industry. Superseded on the `/v3` surface by the enumerated `market_segment` and `revenue_model`. **This field is unchanged on `/v1`, is still populated on every response, and has no removal date** — no action is required.
    - `products_services` (array<string>)
  - `operational_presence` (array<object>)
    - `id` (string)
    - `country_code` (string)
    - `country` (string)
    - `count` (integer)
    - `is_home_jurisdiction` (boolean)
- `message` (string) — Human-readable message about the current status
- `metadata` (object)
  - `last_updated` (string <date-time>) — When the data was last updated
  - `processing_started_at` (string <date-time>) — When processing started (for building/refreshing states)
  - `estimated_completion` (string <date-time>) — Estimated completion time (for building/refreshing states)

```json
{
  "entity_id": "siq_2ZYEAh7VdPkWsvlsqW9lG",
  "status": "complete",
  "data": {
    "id": "siq_2ZYEAh7VdPkWsvlsqW9lG",
    "name": "Google",
    "type": "business",
    "subtype": "incorporated_entity",
    "status": "active",
    "headquarters": {
      "address": {
        "city": "Mountain View",
        "state": "California",
        "country": "United States",
        "state_code": "CA",
        "postal_code": "94043",
        "sub_premise": null,
        "country_code": "US",
        "street_number": null,
        "street_address": "1600 Amphitheatre Parkway",
        "formatted_address": null
      }
    },
    "primary_legal_entity": {
      "id": "le_2Zp3YaC1I4wgYZpQDPgx8",
      "name": "GOOGLE LLC",
      "jurisdiction": {
        "country_code": "US",
        "state_province": "Delaware"
      }
    },
    "attributes": {
      "description": "Google LLC is a global technology company specializing in internet-related services and products. Its core business revolves around online advertising and search engine technology. The company also focuses on cloud computing, computer software, quantum computing, e-commerce, consumer electronics, and artificial intelligence (AI). Google's mission is to organize the world's information and make it universally accessible and useful.",
      "website": "https://goo.gle/3DLEokh",
      "domain": "goo.gle",
      "employee_count": 10001,
      "employee_range": "10K+",
      "revenue": 256700000000,
      "revenue_range": "$10B+",
      "founding_date": "1998-09-04",
      "stock_ticker": null,
      "exchange": null,
      "is_public": null,
      "market_cap": null,
      "funding_total_usd": null,
      "funding_rounds_count": null
    },
    "social_profiles": {
      "crunchbase": {
        "handle": "google"
      },
      "linkedin": {
        "handle": "company/google"
      },
      "facebook": {
        "handle": "Google"
      }
    },
    "classification": {
      "naics_codes_2022": [
        {
          "code": "541511",
          "name": "Custom Computer Programming Services",
          "relevance": 90,
          "confidence": 100,
          "is_primary": false
        },
        {
          "code": "518210",
          "name": "Computing Infrastructure Providers, Data Processing, Web Hosting, and Related Services",
          "relevance": 90,
          "confidence": 100,
          "is_primary": false
        },
        {
          "code": "541512",
          "name": "Computer Systems Design Services",
          "relevance": 70,
          "confidence": 80,
          "is_primary": false
        },
        {
          "code": "513210",
          "name": "Software Publishers",
          "relevance": 70,
          "confidence": 80,
          "is_primary": false
        },
        {
          "code": "51",
          "name": "Information",
          "relevance": 80,
          "confidence": 100,
          "is_primary": false
        }
      ],
      "sic_codes": [
        {
          "code": "7374",
          "name": "Computer Processing and Data Preparation and Processing Services",
          "relevance": 95,
          "confidence": 90,
          "is_primary": true
        },
        {
          "code": "7371",
          "name": "Computer Programming Services",
          "relevance": 90,
          "confidence": 90,
          "is_primary": false
        },
        {
          "code": "7379",
          "name": "Computer Related Services, Not Elsewhere Classified",
          "relevance": 85,
          "confidence": 80,
          "is_primary": false
        },
        {
          "code": "7372",
          "name": "Prepackaged Software",
          "relevance": 75,
          "confidence": 70,
          "is_primary": false
        }
      ],
      "business_tags": [
        "search engine",
        "online advertising",
        "cloud services",
        "artificial intelligence",
        "software development",
        "consumer electronics",
        "data analytics",
        "machine learning",
        "internet services"
      ],
      "business_model": [
        "Advertising",
        "B2C",
        "B2B",
        "Software as a Service (SaaS)",
        "E-commerce"
      ],
      "products_services": [
        "Search Engine",
        "Online Advertising",
        "Cloud Computing (Google Cloud Platform)",
        "Web Navigation (Chrome)",
        "Video Sharing (YouTube)",
        "Email (Gmail)",
        "Navigation and Mapping (Waze, Maps, Earth)",
        "Productivity (Workspace)",
        "Operating Systems (Android, ChromeOS)",
        "Cloud Storage (Drive)",
        "AI (Google Assistant, Gemini)",
        "Machine Learning APIs (TensorFlow)"
      ]
    },
    "operational_presence": [
      {
        "id": "op_30lFgfjlLov9pfV4roOST",
        "country_code": "US",
        "country": "United States of America",
        "count": 49,
        "is_home_jurisdiction": true
      }
    ]
  },
  "message": null,
  "metadata": {
    "last_updated": "2026-03-07T02:47:18.522Z",
    "processing_started_at": null,
    "estimated_completion": null
  }
}
```

### 400 — Bad Request

- `error` (object) — An error object.
  - `message` (string) — The error message
  - `type` (string) — The error code

```json
{
  "error": {
    "message": "Bad request",
    "type": "bad_request"
  }
}
```

### 401 — Unauthorized

- `message` (string) — The error object.
- `request_id` (string) — The request ID for the error.

```json
{
  "message": "No API key found in request",
  "request_id": "d6ed1709fa87777bb373fd60a810e717"
}
```

### 404 — Entity not found

- `message` (string)
- `code` (string)

```json
{
  "message": "Entity not found",
  "code": "entity_not_found"
}
```

### 500 — Internal Server Error

- `error` (object) — An error object.
  - `message` (string) — The error message
  - `type` (string) — The error code

```json
{
  "error": {
    "message": "An unexpected error occurred.",
    "type": "api_error"
  }
}
```

### 502 — Request timeout

- `error` (object) — An error object.
  - `message` (string) — The error message
  - `type` (string) — The error code

```json
{
  "error": {
    "message": "Request timeout",
    "type": "timeout"
  }
}
```