Returns the GLEIF-curated direct family of an entity: its corporate parent and its direct subsidiaries, one level deep. This is the curated, direct-consolidation view of corporate structure, distinct from the raw, all-relationship-types graph at Owner Related.Family edges come from GLEIF Level 2 (the IS_DIRECTLY_CONSOLIDATED_BY relationship). Coverage is therefore limited to LEI-reporting companies: an absent edge does not mean the entity has no parent or subsidiaries, only that none is recorded in GLEIF. An entity not linked to any others, or a company profile with no GLEIF edges, returns { parent: null, children: [] } (a valid 200, not a 404).
“Family” is a group-level relationship: related companies in a corporate tree. It is never an identity claim: Pfizer Inc (US) and Pfizer AG (CH) are distinct entities connected by family, not the same entity.
import { Signa } from "@signa-so/sdk";const signa = new Signa({ api_key: process.env.SIGNA_API_KEY });const family = await signa.entities.family("ent_R3jK9mN2");console.log(family.parent?.name, family.children.length);
To list trademarks across the whole corporate group (parent + all descendants), use the entity_group filter on Search Trademarks: GET /v1/trademarks?entity_group=ent_....
Owner Related: the raw owner-level GLEIF graph (all relationship types, both directions)
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Signa Docs","colors":{"primary":"#555555","light":"#FFFFFF","dark":"#1A1A1A"},"logo":{"light":"https://mintcdn.com/signa-3e9d3658/B1ZmV_4e8OQAWS8j/logo/light.svg?fit=max\u0026auto=format\u0026n=B1ZmV_4e8OQAWS8j\u0026q=85\u0026s=94809fd9be711ab731742afa4d4e58e7","dark":"https://mintcdn.com/signa-3e9d3658/B1ZmV_4e8OQAWS8j/logo/dark.svg?fit=max\u0026auto=format\u0026n=B1ZmV_4e8OQAWS8j\u0026q=85\u0026s=e06fe8c94a3c42e39ba5c55e2e7b60c6","href":"https://signa.so"},"favicon":"https://mintcdn.com/signa-3e9d3658/B1ZmV_4e8OQAWS8j/favicon.png?fit=max\u0026auto=format\u0026n=B1ZmV_4e8OQAWS8j\u0026q=85\u0026s=4d3fc789bb946d02e70cc7f637a2ef2c","api":{"openapi":"https://api.signa.so/v1/openapi.json","playground":{"display":"interactive"},"mdx":{"auth":{"method":"bearer"},"server":"https://api.signa.so"}},"background":{},"navbar":{"links":[{"href":"mailto:support@signa.so","label":"Support"}],"primary":{"type":"button","label":"Get API Key","href":"https://app.signa.so"}},"footer":{"socials":{"x":"https://x.com/signa_so","github":"https://github.com/signa-so","linkedin":"https://linkedin.com/company/signa-so"}},"contextual":{"options":["copy","view","chatgpt","claude","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"signa-3e9d3658","hasAudioNarration":false,"actualSubdomain":"signa-3e9d3658","customDomains":["docs.signa.so"],"gitSource":{"type":"github","owner":"signa-so","repo":"signa","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adcd0b7f55bf8919ffe11ad","collectionId":"2a8b3b4b-fa9e-467b-af29-c18a6c63c0ee","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adcd0b7f55bf8919ffe11ad"},"entitlements":{},"buildId":"6adcd0b7f55bf8919ffe11ad","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"API Reference","count":127},{"language":"default","tag":"Documentation","count":43},{"language":"default","tag":"Monitoring","count":38},{"language":"default","tag":"Filing \u0026 docketing","count":24},{"language":"default","tag":"Administration","count":18},{"language":"default","tag":"Parties","count":16},{"language":"default","tag":"Watches","count":12},{"language":"default","tag":"Records","count":11},{"language":"default","tag":"Reference","count":11},{"language":"default","tag":"Webhooks","count":10}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":".dark a[href=\"https://app.signa.so\"]:not(.link),a[href=\"https://app.signa.so\"]:not(.link),html.dark a[href=\"https://app.signa.so\"]:not(.link){background-color:transparent!important}a[href=\"https://app.signa.so\"]:not(.link)>span:first-child{background-color:#0a0a0a!important}a[href=\"https://app.signa.so\"]:not(.link),a[href=\"https://app.signa.so\"]:not(.link) *{color:#fff!important}a[href=\"https://app.signa.so\"][target=_blank]:not(.link) svg{display:none!important}.dark a[href=\"https://app.signa.so\"]:not(.link)>span:first-child,html.dark a[href=\"https://app.signa.so\"]:not(.link)>span:first-child{background-color:#f0f0f0!important}.dark a[href=\"https://app.signa.so\"]:not(.link),.dark a[href=\"https://app.signa.so\"]:not(.link) *,html.dark a[href=\"https://app.signa.so\"]:not(.link),html.dark a[href=\"https://app.signa.so\"]:not(.link) *{color:#0a0a0a!important}#search-bar-entry,#search-bar-entry-mobile,.sidebar-group a,a[href=\"https://app.signa.so\"]:not(.link),a[href=\"https://app.signa.so\"]:not(.link)>span:first-child,button:not([role=switch]):not([role=tab]){border-radius:9999px!important}#page-context-menu-button{border-radius:.75rem 0 0 .75rem!important}#page-context-menu-button+button{border-radius:0 .75rem .75rem 0!important}#topbar-cta-button>a{padding:.375rem .875rem!important;font-size:.8125rem!important}[data-component-part=update-description],[data-component-part=update-tag]{font-size:.75rem;line-height:1.25rem}[data-component-part=update-tag-list]{flex-direction:column;gap:.25rem}[data-component-part=update-tag]{opacity:.7}[data-component-part=update-content]>h2:first-child{margin-top:0;font-size:1.5rem;line-height:2rem}[data-component-part=update-content] h3{font-size:1rem;margin-top:1.75rem}"}],"page":{"pagePath":"api-reference/parties/entity-family","slug":"/api-reference/parties/entity-family","pageMetadata":{"title":"Entity Family","description":"GLEIF corporate parent and direct subsidiaries of a resolved entity","api":"GET /v1/entities/{id}/family","href":"/api-reference/parties/entity-family"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"GLEIF corporate parent and direct subsidiaries of a resolved entity\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Expandable,Heading,Note,ParamField,ResponseField,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Credits:`}),` 1 per record.`]}),`\n`,_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsxs(_components.p,{children:[`Returns the `,_jsx(_components.strong,{children:`GLEIF-curated direct family`}),` of an entity: its corporate parent and its direct subsidiaries, one level deep. This is the curated, direct-consolidation view of corporate structure, distinct from the raw, all-relationship-types graph at `,_jsx(_components.a,{href:`/api-reference/parties/owner-related`,children:`Owner Related`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Family edges come from GLEIF Level 2 (the `,_jsx(_components.code,{children:`IS_DIRECTLY_CONSOLIDATED_BY`}),` relationship). Coverage is therefore limited to LEI-reporting companies: an `,_jsx(_components.strong,{children:`absent edge does not mean the entity has no parent or subsidiaries`}),`, only that none is recorded in GLEIF. An entity not linked to any others, or a company profile with no GLEIF edges, returns `,_jsx(_components.code,{children:`{ parent: null, children: [] }`}),` (a valid `,_jsx(_components.code,{children:`200`}),`, not a `,_jsx(_components.code,{children:`404`}),`).`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`“Family” is a `,_jsx(_components.strong,{children:`group-level`}),` relationship: related companies in a corporate tree. It is never an identity claim: `,_jsx(_components.code,{children:`Pfizer Inc (US)`}),` and `,_jsx(_components.code,{children:`Pfizer AG (CH)`}),` are distinct entities connected by family, not the same entity.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`path-parameters`,children:`Path Parameters`}),`\n`,_jsx(ParamField,{path:`id`,type:`string`,required:true,id:`param-id`,children:_jsxs(_components.p,{children:[`Entity ID (e.g. `,_jsx(_components.code,{children:`ent_R3jK9mN2`}),`). An owner id written in entity form (`,_jsx(_components.code,{children:`ent_\u003cowner-uuid>`}),`) is a `,_jsx(_components.code,{children:`404`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(ResponseField,{name:`object`,type:`string`,id:`param-object`,children:[`Always `,_jsx(_components.code,{children:`entity_family`}),`.`]}),`\n`,_jsxs(ResponseField,{name:`parent`,type:`object | null`,id:`param-parent`,children:[_jsxs(_components.p,{children:[`The corporate parent, or `,_jsx(_components.code,{children:`null`}),` when none is recorded.`]}),_jsxs(Expandable,{title:`Parent`,children:[_jsxs(ResponseField,{name:`id`,type:`string`,id:`param-id-1`,children:[`Parent entity ID (`,_jsx(_components.code,{children:`ent_*`}),`).`]}),_jsxs(ResponseField,{name:`object`,type:`string`,id:`param-object-1`,children:[`Always `,_jsx(_components.code,{children:`entity`}),`.`]}),_jsx(ResponseField,{name:`name`,type:`string`,id:`param-name`,children:`Parent display name.`}),_jsx(ResponseField,{name:`country_code`,type:`string | null`,id:`param-country-code`,children:`ISO country code.`}),_jsxs(ResponseField,{name:`relationship`,type:`string`,id:`param-relationship`,children:[`Always `,_jsx(_components.code,{children:`parent`}),`.`]}),_jsxs(ResponseField,{name:`source`,type:`string`,id:`param-source`,children:[`Always `,_jsx(_components.code,{children:`gleif`}),`.`]})]})]}),`\n`,_jsx(ResponseField,{name:`children`,type:`object[]`,id:`param-children`,children:_jsxs(_components.p,{children:[`Direct subsidiaries, sorted by name. Each carries `,_jsx(_components.code,{children:`relationship: \"direct_subsidiary\"`}),` and `,_jsx(_components.code,{children:`source: \"gleif\"`}),`.`]})}),`\n`,_jsxs(ResponseField,{name:`source`,type:`string`,id:`param-source-1`,children:[`Always `,_jsx(_components.code,{children:`gleif`}),`.`]}),`\n`,_jsx(ResponseField,{name:`coverage_caveat`,type:`string`,id:`param-coverage-caveat`,children:`A human-readable note that edges are GLEIF Level 2 and cover LEI-reporting companies only.`}),`\n`,_jsx(ResponseField,{name:`request_id`,type:`string`,id:`param-request-id`,children:`Unique request identifier for support.`}),`\n`,`\n`,_jsx(Heading,{level:`2`,id:`code-examples`,children:`Code Examples`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.signa.so/v1/entities/ent_R3jK9mN2/family\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer sig_YOUR_KEY\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`TypeScript`,numberOfLines:`5`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`Signa`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"@signa-so/sdk\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` signa`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` Signa`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({ `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`api_key:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` process`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`env`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`SIGNA_API_KEY`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` });`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` family`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` signa`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`entities`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`family`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ent_R3jK9mN2\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`family`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`parent`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`?.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`name`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`family`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`children`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:`length`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`To list trademarks across the `,_jsx(_components.strong,{children:`whole`}),` corporate group (parent + all descendants), use the `,_jsx(_components.code,{children:`entity_group`}),` filter on `,_jsx(_components.a,{href:`/api-reference/trademarks/search-trademarks`,children:`Search Trademarks`}),`: `,_jsx(_components.code,{children:`GET /v1/trademarks?entity_group=ent_...`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`related-endpoints`,children:`Related Endpoints`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api-reference/parties/retrieve-entity`,children:`Retrieve Entity`}),`: entity detail with members`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api-reference/parties/entity-trademarks`,children:`Entity Trademarks`}),`: marks across all member owners`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api-reference/parties/owner-related`,children:`Owner Related`}),`: the raw owner-level GLEIF graph (all relationship types, both directions)`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Entity Family","description":"GLEIF corporate parent and direct subsidiaries of a resolved entity","api":"GET /v1/entities/{id}/family","href":"/api-reference/parties/entity-family"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Expandable,Heading,Note,ParamField,ResponseExample,ResponseField,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Credits:`}),` 1 per record.`]}),`\n`,_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsxs(_components.p,{children:[`Returns the `,_jsx(_components.strong,{children:`GLEIF-curated direct family`}),` of an entity: its corporate parent and its direct subsidiaries, one level deep. This is the curated, direct-consolidation view of corporate structure, distinct from the raw, all-relationship-types graph at `,_jsx(_components.a,{href:`/api-reference/parties/owner-related`,children:`Owner Related`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Family edges come from GLEIF Level 2 (the `,_jsx(_components.code,{children:`IS_DIRECTLY_CONSOLIDATED_BY`}),` relationship). Coverage is therefore limited to LEI-reporting companies: an `,_jsx(_components.strong,{children:`absent edge does not mean the entity has no parent or subsidiaries`}),`, only that none is recorded in GLEIF. An entity not linked to any others, or a company profile with no GLEIF edges, returns `,_jsx(_components.code,{children:`{ parent: null, children: [] }`}),` (a valid `,_jsx(_components.code,{children:`200`}),`, not a `,_jsx(_components.code,{children:`404`}),`).`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`“Family” is a `,_jsx(_components.strong,{children:`group-level`}),` relationship: related companies in a corporate tree. It is never an identity claim: `,_jsx(_components.code,{children:`Pfizer Inc (US)`}),` and `,_jsx(_components.code,{children:`Pfizer AG (CH)`}),` are distinct entities connected by family, not the same entity.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`path-parameters`,children:`Path Parameters`}),`\n`,_jsx(ParamField,{path:`id`,type:`string`,required:true,id:`param-id`,children:_jsxs(_components.p,{children:[`Entity ID (e.g. `,_jsx(_components.code,{children:`ent_R3jK9mN2`}),`). An owner id written in entity form (`,_jsx(_components.code,{children:`ent_\u003cowner-uuid>`}),`) is a `,_jsx(_components.code,{children:`404`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(ResponseField,{name:`object`,type:`string`,id:`param-object`,children:[`Always `,_jsx(_components.code,{children:`entity_family`}),`.`]}),`\n`,_jsxs(ResponseField,{name:`parent`,type:`object | null`,id:`param-parent`,children:[_jsxs(_components.p,{children:[`The corporate parent, or `,_jsx(_components.code,{children:`null`}),` when none is recorded.`]}),_jsxs(Expandable,{title:`Parent`,children:[_jsxs(ResponseField,{name:`id`,type:`string`,id:`param-id-1`,children:[`Parent entity ID (`,_jsx(_components.code,{children:`ent_*`}),`).`]}),_jsxs(ResponseField,{name:`object`,type:`string`,id:`param-object-1`,children:[`Always `,_jsx(_components.code,{children:`entity`}),`.`]}),_jsx(ResponseField,{name:`name`,type:`string`,id:`param-name`,children:`Parent display name.`}),_jsx(ResponseField,{name:`country_code`,type:`string | null`,id:`param-country-code`,children:`ISO country code.`}),_jsxs(ResponseField,{name:`relationship`,type:`string`,id:`param-relationship`,children:[`Always `,_jsx(_components.code,{children:`parent`}),`.`]}),_jsxs(ResponseField,{name:`source`,type:`string`,id:`param-source`,children:[`Always `,_jsx(_components.code,{children:`gleif`}),`.`]})]})]}),`\n`,_jsx(ResponseField,{name:`children`,type:`object[]`,id:`param-children`,children:_jsxs(_components.p,{children:[`Direct subsidiaries, sorted by name. Each carries `,_jsx(_components.code,{children:`relationship: \"direct_subsidiary\"`}),` and `,_jsx(_components.code,{children:`source: \"gleif\"`}),`.`]})}),`\n`,_jsxs(ResponseField,{name:`source`,type:`string`,id:`param-source-1`,children:[`Always `,_jsx(_components.code,{children:`gleif`}),`.`]}),`\n`,_jsx(ResponseField,{name:`coverage_caveat`,type:`string`,id:`param-coverage-caveat`,children:`A human-readable note that edges are GLEIF Level 2 and cover LEI-reporting companies only.`}),`\n`,_jsx(ResponseField,{name:`request_id`,type:`string`,id:`param-request-id`,children:`Unique request identifier for support.`}),`\n`,_jsx(ResponseExample,{children:_jsx(CodeBlock,{filename:``,numberOfLines:`17`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`17`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"object\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"entity_family\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"parent\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"children\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ent_Qz8mN3rT\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"object\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"entity\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Apple Distribution International Limited\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"country_code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"IE\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"relationship\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"direct_subsidiary\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"source\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"gleif\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"source\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"gleif\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"coverage_caveat\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Family edges are sourced from GLEIF Level 2 (IS_DIRECTLY_CONSOLIDATED_BY) and cover LEI-reporting companies only. An absent edge does not imply the absence of a corporate relationship.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"req_xyz789\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})}),`\n`,_jsx(Heading,{level:`2`,id:`code-examples`,children:`Code Examples`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.signa.so/v1/entities/ent_R3jK9mN2/family\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer sig_YOUR_KEY\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`TypeScript`,numberOfLines:`5`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`Signa`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"@signa-so/sdk\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` signa`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` Signa`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({ `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`api_key:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` process`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`env`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`SIGNA_API_KEY`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` });`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` family`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` signa`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`entities`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`family`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ent_R3jK9mN2\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`family`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`parent`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`?.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`name`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`family`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`children`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:`length`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`To list trademarks across the `,_jsx(_components.strong,{children:`whole`}),` corporate group (parent + all descendants), use the `,_jsx(_components.code,{children:`entity_group`}),` filter on `,_jsx(_components.a,{href:`/api-reference/trademarks/search-trademarks`,children:`Search Trademarks`}),`: `,_jsx(_components.code,{children:`GET /v1/trademarks?entity_group=ent_...`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`related-endpoints`,children:`Related Endpoints`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api-reference/parties/retrieve-entity`,children:`Retrieve Entity`}),`: entity detail with members`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api-reference/parties/entity-trademarks`,children:`Entity Trademarks`}),`: marks across all member owners`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api-reference/parties/owner-related`,children:`Owner Related`}),`: the raw owner-level GLEIF graph (all relationship types, both directions)`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Entity Family","description":"GLEIF corporate parent and direct subsidiaries of a resolved entity","api":"GET /v1/entities/{id}/family","href":"/api-reference/parties/entity-family"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"Path Parameters","slug":"path-parameters","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Code Examples","slug":"code-examples","depth":2,"children":[]},{"title":"Related Endpoints","slug":"related-endpoints","depth":2,"children":[]}],"codeExamples":{"response":{"type":"ResponseExample","children":[{"filename":"","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"17\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"object\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"entity_family\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"parent\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"children\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"ent_Qz8mN3rT\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"object\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"entity\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Apple Distribution International Limited\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"country_code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"IE\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"relationship\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"direct_subsidiary\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"source\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"gleif\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"source\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"gleif\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"coverage_caveat\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Family edges are sourced from GLEIF Level 2 (IS_DIRECTLY_CONSOLIDATED_BY) and cover LEI-reporting companies only. An absent edge does not imply the absence of a corporate relationship.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"request_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"req_xyz789\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Entity Family","path":"/v1/entities/{id}/family","servers":[{"url":"https://api.signa.so"}],"method":"get","request":{"security":[{"title":"Bearer Auth","parameters":{"header":{"Authorization":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token."}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{},"cookie":{},"path":{"id":{"schema":[{"type":"string","description":"Entity ID (e.g. `ent_R3jK9mN2` ). An owner id written in entity form ( `ent_\u003cowner-uuid>` ) is a `404` .","required":true}]}}},"body":{}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"object":[{"type":"string","description":"Always `entity_family` ."}],"parent":[{"type":"object","properties":{"id":[{"type":"string","description":"Parent entity ID ( `ent_*` )."}],"object":[{"type":"string","description":"Always `entity` ."}],"name":[{"type":"string","description":"Parent display name."}],"country_code":[{"type":"object","properties":{},"description":"ISO country code."}],"relationship":[{"type":"string","description":"Always `parent` ."}],"source":[{"type":"string","description":"Always `gleif` ."}]},"description":"The corporate parent, or `null` when none is recorded."}],"children":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"Direct subsidiaries, sorted by name. Each carries `relationship: \"direct_subsidiary\"` and `source: \"gleif\"` ."}],"source":[{"type":"string","description":"Always `gleif` ."}],"coverage_caveat":[{"type":"string","description":"A human-readable note that edges are GLEIF Level 2 and cover LEI-reporting companies only."}],"request_id":[{"type":"string","description":"Unique request identifier for support."}]}}],"examples":{"example":{"value":{"object":"\u003cstring>","parent":{"id":"\u003cstring>","object":"\u003cstring>","name":"\u003cstring>","country_code":{},"relationship":"\u003cstring>","source":"\u003cstring>"},"children":[{}],"source":"\u003cstring>","coverage_caveat":"\u003cstring>","request_id":"\u003cstring>"}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"signa-3e9d3658","siteName":"Signa Docs","title":"Entity Family - Signa Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-28T19:09:10.150Z","originalFileLocation":"api-reference/parties/entity-family.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"GLEIF corporate parent and direct subsidiaries of a resolved entity\">\u003cmeta data-mint-head name=\"application-name\" content=\"Signa Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/signa-3e9d3658/dQGWgfNCEyUjAsUh/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/signa-3e9d3658/dQGWgfNCEyUjAsUh/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/signa-3e9d3658/dQGWgfNCEyUjAsUh/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/signa-3e9d3658/dQGWgfNCEyUjAsUh/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/signa-3e9d3658/dQGWgfNCEyUjAsUh/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/signa-3e9d3658/dQGWgfNCEyUjAsUh/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/signa-3e9d3658/dQGWgfNCEyUjAsUh/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/signa-3e9d3658/dQGWgfNCEyUjAsUh/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/signa-3e9d3658/dQGWgfNCEyUjAsUh/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Entity Family - Signa Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"GLEIF corporate parent and direct subsidiaries of a resolved entity\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Signa Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.signa.so/api-reference/parties/entity-family\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://signa-3e9d3658.mintlify.app/_mintlify/api/og/v2?division=Entities\u0026amp;title=Entity+Family\u0026amp;description=GLEIF+corporate+parent+and+direct+subsidiaries+of+a+resolved+entity\u0026amp;theme=6da1633f5a817117a5d2a1f8\u0026amp;signature=45f76360f12b37ed80fa1ba43ee48b1400dc9f6aec5a2795083ef4f6cca403fc\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Entity Family - Signa Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"GLEIF corporate parent and direct subsidiaries of a resolved entity\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://signa-3e9d3658.mintlify.app/_mintlify/api/og/v2?division=Entities\u0026amp;title=Entity+Family\u0026amp;description=GLEIF+corporate+parent+and+direct+subsidiaries+of+a+resolved+entity\u0026amp;theme=6da1633f5a817117a5d2a1f8\u0026amp;signature=45f76360f12b37ed80fa1ba43ee48b1400dc9f6aec5a2795083ef4f6cca403fc\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/signa-3e9d3658/dQGWgfNCEyUjAsUh/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Signa Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#555555\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.signa.so/api-reference/parties/entity-family\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/parties/entity-family.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.signa.so/#organization\",\"name\":\"Signa Docs\",\"url\":\"https://docs.signa.so\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/signa-3e9d3658/B1ZmV_4e8OQAWS8j/logo/light.svg?fit=max\u0026auto=format\u0026n=B1ZmV_4e8OQAWS8j\u0026q=85\u0026s=94809fd9be711ab731742afa4d4e58e7\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.signa.so#website\",\"name\":\"Signa Docs\",\"url\":\"https://docs.signa.so\",\"publisher\":{\"@id\":\"https://docs.signa.so/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.signa.so/api-reference/parties/entity-family#webpage\",\"url\":\"https://docs.signa.so/api-reference/parties/entity-family\",\"name\":\"Entity Family\",\"description\":\"GLEIF corporate parent and direct subsidiaries of a resolved entity\",\"dateModified\":\"2026-09-28T19:09:10.150Z\",\"isPartOf\":{\"@id\":\"https://docs.signa.so#website\"},\"breadcrumb\":{\"@id\":\"https://docs.signa.so/api-reference/parties/entity-family#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.signa.so/api-reference/parties/entity-family#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Parties\",\"item\":\"https://docs.signa.so/api-reference/parties/search-entities\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Entities\",\"item\":\"https://docs.signa.so/api-reference/parties/search-entities\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Entity Family\",\"item\":\"https://docs.signa.so/api-reference/parties/entity-family\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.signa.so/api-reference/parties/entity-family#apireference\",\"headline\":\"Entity Family\",\"name\":\"Entity Family\",\"description\":\"GLEIF corporate parent and direct subsidiaries of a resolved entity\",\"url\":\"https://docs.signa.so/api-reference/parties/entity-family\",\"mainEntityOfPage\":{\"@id\":\"https://docs.signa.so/api-reference/parties/entity-family#webpage\"},\"dateModified\":\"2026-09-28T19:09:10.150Z\",\"publisher\":{\"@id\":\"https://docs.signa.so/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.signa.so#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Signa Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Signa Docs","nav":{"global":{"anchors":[]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"Pagination","href":"/api-reference/pagination"},{"title":"Rate Limits \u0026 Credits","href":"/api-reference/rate-limits"},{"title":"Errors","href":"/api-reference/errors"}]},{"group":"Trademarks","pages":[{"group":"Search","pages":[{"title":"Search Trademarks","api":"GET /v1/trademarks","href":"/api-reference/trademarks/search-trademarks"},{"title":"Search by Image","api":"POST /v1/trademarks/search/image","tag":"ALPHA","href":"/api-reference/trademarks/trademark-image-search"}]},{"group":"Retrieve","pages":[{"title":"Retrieve Trademark","api":"GET /v1/trademarks/{id}","href":"/api-reference/trademarks/retrieve-trademark"},{"title":"Batch Retrieve","api":"POST /v1/trademarks/batch","href":"/api-reference/trademarks/batch-trademarks"}]},{"group":"Records","pages":[{"title":"Trademark Events","api":"GET /v1/trademarks/{id}/events","href":"/api-reference/trademarks/trademark-events"},{"title":"Trademark Proceedings","api":"GET /v1/trademarks/{id}/proceedings","href":"/api-reference/trademarks/trademark-proceedings"},{"title":"Trademark Assignments","api":"GET /v1/trademarks/{id}/assignments","href":"/api-reference/trademarks/trademark-assignments"},{"title":"Trademark Citations","api":"GET /v1/trademarks/{id}/citations","href":"/api-reference/trademarks/trademark-citations"},{"title":"Trademark Cited By","api":"GET /v1/trademarks/{id}/cited-by","href":"/api-reference/trademarks/trademark-cited-by"},{"title":"Trademark Documents","api":"GET /v1/trademarks/{id}/documents","href":"/api-reference/trademarks/records/documents"}]}]},{"group":"Parties","pages":[{"group":"Entities","pages":[{"title":"Search Entities","api":"GET /v1/entities","href":"/api-reference/parties/search-entities"},{"title":"Retrieve Entity","api":"GET /v1/entities/{id}","href":"/api-reference/parties/retrieve-entity"},{"title":"Entity Trademarks","description":"List all trademarks of a resolved entity, across every office it is linked in","api":"GET /v1/entities/{id}/trademarks","href":"/api-reference/parties/entity-trademarks"},{"title":"Entity Family","api":"GET /v1/entities/{id}/family","href":"/api-reference/parties/entity-family"}]},{"group":"Owners","pages":[{"title":"Search Owners","description":"Search trademark owners with filtering, public-company joins, and cursor pagination","api":"GET /v1/owners","href":"/api-reference/parties/search-owners"},{"title":"Retrieve Owner","api":"GET /v1/owners/{id}","href":"/api-reference/parties/retrieve-owner"},{"title":"Owner Trademarks","api":"GET /v1/owners/{id}/trademarks","href":"/api-reference/parties/owner-trademarks"},{"title":"Owner Related Entities","api":"GET /v1/owners/{id}/related","href":"/api-reference/parties/owner-related"}]},{"group":"Attorneys","pages":[{"title":"Search Attorneys","api":"GET /v1/attorneys","href":"/api-reference/parties/search-attorneys"},{"title":"Retrieve Attorney","api":"GET /v1/attorneys/{id}","href":"/api-reference/parties/retrieve-attorney"},{"title":"Attorney Trademarks","api":"GET /v1/attorneys/{id}/trademarks","href":"/api-reference/parties/attorney-trademarks"},{"title":"Attorney Clients","api":"GET /v1/attorneys/{id}/clients","href":"/api-reference/parties/attorney-clients"}]},{"group":"Firms","pages":[{"title":"Search Firms","api":"GET /v1/firms","href":"/api-reference/parties/search-firms"},{"title":"Retrieve Firm","api":"GET /v1/firms/{id}","href":"/api-reference/parties/retrieve-firm"},{"title":"Firm Trademarks","api":"GET /v1/firms/{id}/trademarks","href":"/api-reference/parties/firm-trademarks"},{"title":"Firm Attorneys","api":"GET /v1/firms/{id}/attorneys","href":"/api-reference/parties/firm-attorneys"}]}]},{"group":"Records","pages":[{"group":"Proceedings","pages":[{"title":"Search Proceedings","api":"GET /v1/proceedings","href":"/api-reference/proceedings/search-proceedings"},{"title":"Retrieve Proceeding","api":"GET /v1/proceedings/{id}","href":"/api-reference/proceedings/retrieve-proceeding"}]},{"group":"Assignments","pages":[{"title":"Search Assignments","api":"GET /v1/assignments","href":"/api-reference/records/transactions/search-assignments"},{"title":"Retrieve Assignment","api":"GET /v1/assignments/{id}","href":"/api-reference/records/transactions/retrieve-assignment"}]},{"group":"Citations","pages":[{"title":"Search Citations","api":"GET /v1/citations","href":"/api-reference/citations/search-citations"}]}]},{"group":"Intelligence","pages":[{"group":"Screening","pages":[{"title":"Screen a Name","api":"GET /v1/screening","tag":"ALPHA","href":"/api-reference/screening/screen"},{"title":"Check a Listing","api":"POST /v1/screening/listings","tag":"ALPHA","href":"/api-reference/screening/check-listing"}]},{"group":"Compare","pages":[{"title":"Compare Marks","api":"POST /v1/compare","tag":"ALPHA","href":"/api-reference/compare/compare"}]}]},{"group":"Filing \u0026 docketing","pages":[{"group":"Classification","pages":[{"title":"List Classifications","api":"GET /v1/classifications","href":"/api-reference/reference/list-classifications"},{"title":"Retrieve Classification","api":"GET /v1/classifications/{classNumber}","href":"/api-reference/reference/retrieve-classification"},{"title":"List Goods \u0026 Services","api":"GET /v1/goods-services","href":"/api-reference/reference/list-goods-services"},{"title":"Suggest Classifications","api":"POST /v1/classifications/suggest","href":"/api-reference/reference/suggest-classifications"},{"title":"Suggest Goods \u0026 Services","api":"POST /v1/goods-services/suggest","href":"/api-reference/reference/suggest-goods-services"},{"title":"Validate Goods \u0026 Services","api":"POST /v1/goods-services/validate","href":"/api-reference/reference/validate-goods-services"}]},{"group":"Deadlines","pages":[{"title":"List Deadlines","api":"GET /v1/deadlines","href":"/api-reference/reference/list-deadlines"},{"title":"Compute Deadlines","api":"POST /v1/deadlines/compute","href":"/api-reference/reference/compute-deadlines"},{"title":"Compute Oppositions","api":"POST /v1/oppositions/compute","href":"/api-reference/reference/compute-oppositions"},{"title":"List Deadline Rules","api":"GET /v1/deadline-rules","href":"/api-reference/reference/deadline-rules"},{"title":"List Opposition Rules","api":"GET /v1/opposition-rules","href":"/api-reference/reference/opposition-rules"},{"title":"List Prosecution Rules","api":"GET /v1/prosecution-rules","href":"/api-reference/reference/prosecution-rules"}]},{"group":"Fees","pages":[{"title":"List Fees","api":"GET /v1/fees","href":"/api-reference/fees/list"},{"title":"Estimate Fees","api":"POST /v1/fees/estimate","href":"/api-reference/fees/estimate"}]},{"group":"Reconcile","pages":[{"title":"Reconcile","api":"POST /v1/reconcile","href":"/api-reference/reference/reconcile"}]},{"group":"Portfolios","pages":[{"title":"Create Portfolio","api":"POST /v1/portfolios","href":"/api-reference/portfolios/create"},{"title":"List Portfolios","api":"GET /v1/portfolios","href":"/api-reference/portfolios/list"},{"title":"Retrieve Portfolio","api":"GET /v1/portfolios/{id}","href":"/api-reference/portfolios/retrieve"},{"title":"Update Portfolio","api":"PATCH /v1/portfolios/{id}","href":"/api-reference/portfolios/update"},{"title":"Delete Portfolio","api":"DELETE /v1/portfolios/{id}","href":"/api-reference/portfolios/delete"},{"title":"Add Trademarks","api":"POST /v1/portfolios/{id}/trademarks","href":"/api-reference/portfolios/add-trademarks"},{"title":"Remove Trademarks","api":"POST /v1/portfolios/{id}/trademarks/remove","href":"/api-reference/portfolios/remove-trademarks"},{"title":"List Portfolio Deadlines","api":"GET /v1/portfolios/{id}/deadlines","href":"/api-reference/portfolios/deadlines"},{"title":"Download Portfolio Calendar","api":"GET /v1/portfolios/{id}/deadlines.ics","href":"/api-reference/portfolios/deadlines-ics"}]}]},{"group":"Monitoring","pages":[{"group":"Watches","pages":[{"title":"Create Watch","api":"POST /v1/watches","href":"/api-reference/monitoring/watches/create"},{"title":"List Watches","api":"GET /v1/watches","href":"/api-reference/monitoring/watches/list"},{"title":"Retrieve Watch","api":"GET /v1/watches/{id}","href":"/api-reference/monitoring/watches/retrieve"},{"title":"Update Watch","api":"PATCH /v1/watches/{id}","href":"/api-reference/monitoring/watches/update"},{"title":"Delete Watch","api":"DELETE /v1/watches/{id}","href":"/api-reference/monitoring/watches/delete"},{"title":"Pause Watch","api":"POST /v1/watches/{id}/pause","href":"/api-reference/monitoring/watches/pause"},{"title":"Resume Watch","api":"POST /v1/watches/{id}/resume","href":"/api-reference/monitoring/watches/resume"},{"title":"Preview Watch","api":"POST /v1/watches/preview","href":"/api-reference/monitoring/watches/preview"},{"title":"Bulk Create Watches","api":"POST /v1/watches/bulk","href":"/api-reference/monitoring/watches/bulk"},{"title":"Watch Diagnostics","api":"GET /v1/watches/{id}/diagnostics","href":"/api-reference/monitoring/watches/diagnostics"},{"title":"Watch Attestation","api":"GET /v1/watches/{id}/attestation","href":"/api-reference/monitoring/watches/attestation"},{"title":"Monitoring Status","api":"GET /v1/monitoring/status","href":"/api-reference/monitoring/watches/monitoring-status"}]},{"group":"Alerts","pages":[{"title":"List Alerts","api":"GET /v1/alerts","href":"/api-reference/monitoring/alerts/list"},{"title":"Retrieve Alert","api":"GET /v1/alerts/{id}","href":"/api-reference/monitoring/alerts/retrieve"},{"title":"Lookup Alerts","api":"POST /v1/alerts/lookup","href":"/api-reference/monitoring/alerts/lookup"},{"title":"List Alerts for Watch","api":"GET /v1/watches/{id}/alerts","href":"/api-reference/monitoring/alerts/list-for-watch"}]},{"group":"Events","pages":[{"title":"List Events","api":"GET /v1/events","href":"/api-reference/monitoring/events/list"},{"title":"Retrieve Event","api":"GET /v1/events/{id}","href":"/api-reference/monitoring/events/retrieve"}]},{"group":"Webhooks","pages":[{"title":"Create Webhook","api":"POST /v1/webhooks","href":"/api-reference/monitoring/webhooks/create"},{"title":"List Webhooks","api":"GET /v1/webhooks","href":"/api-reference/monitoring/webhooks/list"},{"title":"Retrieve Webhook","api":"GET /v1/webhooks/{id}","href":"/api-reference/monitoring/webhooks/retrieve"},{"title":"Update Webhook","api":"PATCH /v1/webhooks/{id}","href":"/api-reference/monitoring/webhooks/update"},{"title":"Delete Webhook","api":"DELETE /v1/webhooks/{id}","href":"/api-reference/monitoring/webhooks/delete"},{"title":"Rotate Webhook Secret","api":"POST /v1/webhooks/{id}/rotate-secret","href":"/api-reference/monitoring/webhooks/rotate-secret"},{"title":"Test Webhook","api":"POST /v1/webhooks/{id}/test","href":"/api-reference/monitoring/webhooks/test"},{"title":"List Deliveries","api":"GET /v1/webhooks/{id}/deliveries","href":"/api-reference/monitoring/webhooks/list-deliveries"},{"title":"Retrieve Delivery","api":"GET /v1/webhooks/{id}/deliveries/{did}","href":"/api-reference/monitoring/webhooks/retrieve-delivery"},{"title":"Redeliver Delivery","api":"POST /v1/webhooks/{id}/deliveries/{did}/redeliver","href":"/api-reference/monitoring/webhooks/redeliver"}]}]},{"group":"Analytics","pages":[{"group":"Filing Analytics","pages":[{"title":"Market Analytics","api":"GET /v1/analytics/market","href":"/api-reference/analytics/market"},{"title":"Office Analytics","api":"GET /v1/analytics/offices/{code}","href":"/api-reference/analytics/office-analytics"},{"title":"Classification Analytics","api":"GET /v1/analytics/classifications/{class}","href":"/api-reference/analytics/classification-analytics"}]},{"group":"Party Analytics","pages":[{"title":"Entity Analytics","api":"GET /v1/entities/{id}/analytics","href":"/api-reference/parties/entity-analytics"},{"title":"Owner Analytics","api":"GET /v1/owners/{id}/analytics","href":"/api-reference/parties/owner-analytics"},{"title":"Attorney Analytics","api":"GET /v1/attorneys/{id}/analytics","href":"/api-reference/parties/attorney-analytics"},{"title":"Firm Analytics","api":"GET /v1/firms/{id}/analytics","href":"/api-reference/parties/firm-analytics"}]}]},{"group":"Reference","pages":[{"group":"Offices","pages":[{"title":"List Offices","api":"GET /v1/offices","href":"/api-reference/reference/list-offices"},{"title":"Retrieve Office","api":"GET /v1/offices/{code}","href":"/api-reference/reference/retrieve-office"},{"title":"List Office Votes","api":"GET /v1/offices/votes","href":"/api-reference/reference/list-office-votes"},{"title":"Cast Office Votes","api":"POST /v1/offices/votes","href":"/api-reference/reference/cast-office-votes"},{"title":"Retract Office Vote","api":"DELETE /v1/offices/votes/{code}","href":"/api-reference/reference/retract-office-vote"}]},{"group":"Jurisdictions","pages":[{"title":"List Jurisdictions","api":"GET /v1/jurisdictions","href":"/api-reference/reference/list-jurisdictions"},{"title":"Retrieve Jurisdiction","api":"GET /v1/jurisdictions/{code}","href":"/api-reference/reference/retrieve-jurisdiction"}]},{"group":"Codes \u0026 types","pages":[{"title":"List Design Codes","api":"GET /v1/design-codes","href":"/api-reference/reference/list-design-codes"},{"title":"Retrieve Design Code","api":"GET /v1/design-codes/{code}","href":"/api-reference/reference/retrieve-design-code"},{"title":"List Event Types","api":"GET /v1/event-types","href":"/api-reference/reference/list-event-types"},{"title":"List Status Codes","api":"GET /v1/status-codes","href":"/api-reference/reference/list-status-codes"}]}]},{"group":"Administration","pages":[{"group":"Organization","pages":[{"title":"Get Current Organization","api":"GET /v1/organization/me","href":"/api-reference/administration/get-me"}]},{"group":"API Keys","pages":[{"title":"List API Keys","api":"GET /v1/organization/api-keys","href":"/api-reference/administration/list-api-keys"},{"title":"Create API Key","api":"POST /v1/organization/api-keys","href":"/api-reference/administration/create-api-key"},{"title":"Retrieve API Key","api":"GET /v1/organization/api-keys/{id}","href":"/api-reference/administration/retrieve-api-key"},{"title":"Update API Key","api":"PATCH /v1/organization/api-keys/{id}","href":"/api-reference/administration/update-api-key"},{"title":"Revoke API Key","api":"DELETE /v1/organization/api-keys/{id}","href":"/api-reference/administration/delete-api-key"},{"title":"Rotate API Key","api":"POST /v1/organization/api-keys/{id}/rotate","href":"/api-reference/administration/rotate-api-key"}]},{"group":"Usage \u0026 Credits","pages":[{"title":"Get Usage","api":"GET /v1/organization/usage","href":"/api-reference/administration/get-usage"},{"title":"Get Usage Summary","api":"GET /v1/organization/usage/summary","href":"/api-reference/administration/get-usage-summary"},{"title":"Get Usage Estimate","api":"GET /v1/organization/usage/estimate","href":"/api-reference/administration/get-usage-estimate"},{"title":"Get Credits","api":"GET /v1/organization/credits","href":"/api-reference/administration/get-credits"},{"title":"Get Credit Pricing","openapi":"GET /v1/credits/pricing","href":"/api-reference/administration/get-credit-pricing"}]},{"group":"Logs","pages":[{"title":"List Request Logs","api":"GET /v1/organization/logs","href":"/api-reference/administration/get-logs"},{"title":"Retrieve Request Log","api":"GET /v1/organization/logs/{request_id}","href":"/api-reference/administration/retrieve-log"}]},{"group":"Feedback","pages":[{"title":"Submit Feedback","api":"POST /v1/feedback","href":"/api-reference/administration/create-feedback"},{"title":"List Feedback","api":"GET /v1/feedback","href":"/api-reference/administration/list-feedback"},{"title":"Retrieve Feedback","api":"GET /v1/feedback/{id}","href":"/api-reference/administration/get-feedback"}]},{"group":"Health","pages":[{"title":"Health Check","api":"GET /v1/health","href":"/api-reference/health"}]}]},{"group":"SDK","pages":[{"title":"TypeScript SDK","sidebarTitle":"TypeScript SDK","href":"/sdk/typescript"}]}]},{"tab":"Research","pages":[{"title":"Research","href":"/research"}]}]},"title":"Entity Family - Signa Docs","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-Bbp7I60D.js","utils-C3RIvJha.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DqD-vLt8.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B31Loprg.js","snippetPresets-DKpk-b8t.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Cj65AhOR.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BXtn5gcC.js","shallow-RY2b03Cp.js","getApiPlaygroundDisplay-B0jeiPk3.js","CodeSnippet-CYgBjjwn.js","CodeSnippets-DOngDrYB.js","Page-n7I5XbKb.js","getPastedJson-DRQbJx-T.js","icon-CQiQCicY.js","MethodPill-BKTLdNtu.js","DuplicateIcon-B9jpAdat.js","createIcon-DCddRrXv.js","DynamicMarkdown-a8hUKrw6.js","SectionHeading-eECVV2eH.js","axios-vUo_bRtp.js"]}