---
title: "Issuer-specific extension concepts (qnames outside standard taxonomies)"
method: GET
path: "/api/v1/entities/{entity_id}/extension-concepts"
tags: ["Entities"]
---

# Issuer-specific extension concepts (qnames outside standard taxonomies)

`GET /api/v1/entities/{entity_id}/extension-concepts`

## Request

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

Concepts a filer declared outside the standard us-gaap / ifrs-full taxonomies, with item-type / period-type / balance, usage count, mapping status, and an optional single ML `suggested_hub_code` + confidence.

Sorted by usage_count desc, `limit` clamped to [1, 100]. `status_filter` ∈ all | mapped | unmappable | pending | processing | review.

## Path parameters

- `entity_id` string, required

## Query parameters

- `status_filter` string: all (default) | mapped (tied to a Hub-Equity concept).
- `limit` integer: Max rows (clamped to 100). Default 30.

## Response `200`

Extension concepts for the entity.

- ApiResponseExtensionConceptsResult
  - `success` boolean, required
  - `data` ExtensionConceptsResult
    - `entity_id` string, required
    - `entity_name` string, required
    - `total_count` integer, required
    - `extensions` ExtensionConcept[], required
      - `qname` string, required
      - `local_name` string, nullable
      - `namespace` string, nullable
      - `label` string, nullable
      - `label_fr` string, nullable
      - `item_type` string, nullable: xbrli:monetaryItemType / xbrli:stringItemType / etc
      - `period_type` string, nullable: instant | duration
      - `balance` string, nullable: debit | credit | null
      - `substitution_group` string, nullable
      - `abstract` boolean, nullable
      - `usage_count` integer
      - `sample_value` string, nullable
      - `documentation` string, nullable: Issuer's own documentation label for this concept, verbatim from its label linkbase. Null when absent or when it merely copies the label.
      - `canonical_section` string, nullable: Accounting section inferred from the issuer's own presentation link-role URIs (P&L / BS / CF / OCI / EQUITY / DISCLOSURE_*).
      - `anchored_to` string, nullable: The standard concept this extension is anchored to, as the issuer itself declared it in the ESMA wider-narrower arc of its own definition linkbase (ESEF filers, mandatory since 2020). Read from the issuer's most recent filing that carries the arc. Null when the issuer declared none (US filers do not anchor).
      - `anchor_direction` 'narrower' | 'wider', nullable: 'narrower' : the extension is narrower than `anchored_to` (the usual case) ; 'wider' : the extension is wider than it.
    - `applied_filters` object
    - `notes` string[]
  - `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

- `404`: Entity not found.
- `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)