---
title: "Get DEI attributes for an entity"
method: GET
path: "/api/v1/entities/{entity_id}/dei"
tags: ["Entities"]
---

# Get DEI attributes for an entity

`GET /api/v1/entities/{entity_id}/dei`

## Request

- Base URL: `https://api.hub-equity.com`
- URL: `https://api.hub-equity.com/api/v1/entities/{entity_id}/dei`
- Auth: HTTP bearer

Returns DEI (Document and Entity Information) attributes extracted from the entity's latest SEC filing — employees, incorporation date, legal form, regulatory flags, public float, auditor, etc.

## Path parameters

- `entity_id` string, required

## Response `200`

Successful Response

- ApiResponseEntityDei
  - `success` boolean, required
  - `data` EntityDei: DEI attributes for an entity (from the latest filing).
    - `entity_id` string, required
    - `source_filing_id` string, nullable, required
    - `source_fiscal_year` integer, nullable, required
    - `source_period_end` string, nullable, required
    - `number_of_employees` integer, nullable, required
    - `incorporation_date` string, nullable, required
    - `bankruptcy_flag` boolean, nullable, required
    - `legal_form` string, nullable, required
    - `former_name` string, nullable, required
    - `former_name_change_date` string, nullable, required
    - `parent_entity_legal_name` string, nullable, required
    - `home_country_iso` string, nullable, required
    - `incorporation_state_country` string, nullable, required
    - `reporting_currency_iso` string, nullable, required
    - `lei_from_filing` string, nullable, required
    - `ein` string, nullable, required
    - `duns` string, nullable, required
    - `sic_primary` string, nullable, required
    - `filer_category` string, nullable, required
    - `well_known_seasoned_issuer` boolean, nullable, required
    - `voluntary_filer` boolean, nullable, required
    - `current_reporting_status` boolean, nullable, required
    - `small_business` boolean, nullable, required
    - `emerging_growth_company` boolean, nullable, required
    - `shell_company` boolean, nullable, required
    - `ex_transition_period` boolean, nullable, required
    - `inv_company_type` string, nullable, required
    - `public_float` number, nullable, required
    - `common_shares_outstanding` number, nullable, required
    - `common_shares_outstanding_by_class` object[], nullable
    - `auditor_id` string, nullable, required
    - `auditor_name` string, nullable, required
    - `auditor_pcaob_firm_id` string, nullable, required
    - `auditor_location` string, nullable, required
    - `auditor_opinion_excerpt` string, nullable, required
    - `icfr_auditor_attestation_flag` boolean, nullable
    - `icfr_attestation_status` string, nullable
    - `material_weakness_disclosed` boolean, nullable
    - `fiscal_year_end_month` integer, nullable
    - `fiscal_year_end_day` integer, nullable
  - `error` ApiError: API error details.
    - `code` string, required
    - `message` string, required
    - `details` object, nullable
  - `meta` ApiMeta: API response metadata. Pagination fields (``page`` / ``per_page`` / ``total``) are populated on collection endpoints only. They are omitted from the payload on single-resource endpoints.
    - `timestamp` string, date-time
    - `request_id` string, nullable
    - `page` integer, nullable
    - `per_page` integer, nullable
    - `total` integer, nullable
  - `links` ApiLinks: HATEOAS-style pagination cursors. Host-relative path + query links for a collection page. Present on collection endpoints, ``null`` fields where a page doesn't exist (``next`` on the last page, ``prev`` on the first). The whole ``links`` object is omitted from single-resource responses (see ``ApiResponse`` serializer).
    - `self` string, nullable
    - `first` string, nullable
    - `prev` string, nullable
    - `next` string, nullable
    - `last` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/hub-equity/apis/hub-equity-api.md) · [All operations](https://skmtc.dev/hub-equity/apis/hub-equity-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hub-equity/apis/hub-equity-api/revisions/e8eeda5dc13e?raw)