> ## Documentation Index
> Fetch the complete documentation index at: https://docs.signa.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Entities

> Resolved entities, owners, attorneys, and law firms

Signa models the parties behind a trademark — and links the same company's records together across offices into a single **resolved entity**.

## Party types

| Type         | Prefix  | What it is                                                                           |
| ------------ | ------- | ------------------------------------------------------------------------------------ |
| **Entity**   | `ent_`  | The cross-office identity linking the owner records that belong to the same company. |
| **Owner**    | `own_`  | A single office's applicant/registrant record, as that office filed it.              |
| **Attorney** | `att_`  | Named attorney of record on a trademark.                                             |
| **Firm**     | `firm_` | Law firm associated with the attorney.                                               |

Owners and entities each have their own API surface. Attorneys and firms appear on the trademark records they're associated with.

## Resolved entities

The same company files in every office it cares about, and each office keeps its own owner record with its own spelling. A **resolved entity** links those owner records into one object, so you can see a company's complete footprint across offices at once.

Signa **links, it doesn't merge** — the per-office owner records are never rewritten, so `own_` IDs stay stable while the entity points at them.

```bash theme={null}
GET /v1/entities/ent_R3jK9mN2
```

A resolved entity gives you:

* **Members** — the owner records it links, one per office, each with the evidence that justified the link.
* **Global portfolio** — every mark across all members in one filterable list (`/v1/entities/{id}/trademarks`).
* **Corporate family** — the GLEIF parent and direct subsidiaries (`/v1/entities/{id}/family`).
* **Public-company facts** — `ticker`, `lei`, `publicly_traded`, aggregated across the company's office records.

<Card title="How entities are resolved" icon="layer-group" href="/guides/entity-resolution">
  Linking signals, adjudication, accuracy, and ID/merge handling — the full deep dive.
</Card>

## Owners

An owner is a single office's record of an applicant or registrant. Each owner profile carries:

* **Canonical name** — the normalized, deduplicated form used for matching (the original display `name` is also returned).
* **Country** — primary jurisdiction.
* **Public-company links** — SEC (CIK) and GLEIF (LEI) identifiers when matched.
* **Statistics** — filing counts, active marks, Nice-class distribution, top jurisdictions.

```bash theme={null}
GET /v1/owners/own_abc123
```

Use **owners** when you need the exact per-office record; use **entities** for company-level questions ("everything this company owns, everywhere").

## Corporate relationships

Signa connects corporate parents and subsidiaries from GLEIF Level 2 data. The entity family is the primary surface:

```bash theme={null}
GET /v1/entities/ent_R3jK9mN2/family
```

<Note>
  GLEIF Level 2 covers LEI-reporting companies only — an absent edge does not
  imply the absence of a corporate relationship.
</Note>

## Endpoints

| Endpoint                                                                       | Purpose                                 |
| ------------------------------------------------------------------------------ | --------------------------------------- |
| [`GET /v1/entities`](/api-reference/parties/list-entities)                     | Search and filter resolved entities     |
| [`GET /v1/entities/{id}`](/api-reference/parties/get-entity)                   | One entity with members + link evidence |
| [`GET /v1/entities/{id}/trademarks`](/api-reference/parties/entity-trademarks) | Global portfolio across all members     |
| [`GET /v1/entities/{id}/family`](/api-reference/parties/entity-family)         | GLEIF corporate parent and subsidiaries |
| [`GET /v1/owners`](/api-reference/parties/list-owners)                         | Search and filter owners                |
| [`GET /v1/owners/{id}`](/api-reference/parties/get-owner)                      | A single per-office owner record        |

<Card title="Entity Resolution" icon="sitemap" href="/guides/entity-resolution">
  How Signa links owners into resolved entities across offices.
</Card>