> ## 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.

# Owner Trademarks

> List a trademark owner's portfolio with the standard trademark filters

## Overview

Returns a paginated list of trademarks held by the specified owner. Use this for portfolio views, competitor intelligence, or auditing an owner's IP holdings across jurisdictions.

When neither `sort` nor `q` is supplied, results default to most-recent-first (`-filing_date`); a `q` text query instead ranks by relevance. Arrays are comma-separated, date ranges use flat `_gte`, `_gt`, `_lte`, and `_lt` operators, and booleans must be the literal strings `true` or `false`.

## Path Parameters

<ParamField path="id" type="string" required>
  Owner ID (e.g. `own_R3jK9mN2`).
</ParamField>

## Query Parameters

The full [List Trademarks](/api-reference/trademarks/list-trademarks) filter set applies (status, mark classification, identifiers, geography, Nice/Vienna codes, date ranges, public-company filters, and boolean flags), plus:

<ParamField query="q" type="string">Search query text within this owner's trademarks.</ParamField>
<ParamField query="sort" type="string" default="-filing_date">Sort field(s), comma-separated, `-` prefix for descending.</ParamField>
<ParamField query="attorney_id" type="string">Filter to marks prosecuted by a specific attorney (`att_...`).</ParamField>
<ParamField query="firm_id" type="string">Filter to marks handled by a specific firm (`firm_...`).</ParamField>
<ParamField query="include" type="string">Comma-separated optional row projections. `full_goods_services` returns full `classifications[].goods_services_text` instead of the truncated summary text.</ParamField>
<ParamField query="fields" type="string">Sparse top-level field projection, comma-separated. `id` and `object` are always retained. Unknown names return `400`.</ParamField>
<ParamField query="limit" type="integer" default="20">Items per page (1-100).</ParamField>
<ParamField query="cursor" type="string">Pagination cursor from a previous response.</ParamField>

## Response

<ResponseField name="data" type="object[]">
  Array of trademark summary objects belonging to this owner.
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "object": "list",
    "data": [
      {
        "id": "tm_8kLm2nPq",
        "object": "trademark",
        "mark_text": "AURORA",
        "status": { "primary": "active", "stage": "registered" },
        "office_code": "uspto",
        "jurisdiction_code": "US",
        "filing_date": "2023-04-12",
        "registration_date": "2024-09-18",
        "classifications": [
          { "nice_class": 9, "goods_services_text": "Downloadable software for digital image processing" },
          { "nice_class": 35, "goods_services_text": "Online retail store services featuring digital media" },
          { "nice_class": 42, "goods_services_text": "Software as a service (SaaS) featuring media management tools" }
        ],
        "owners": [
          {
            "id": "own_7nQp3xYz",
            "name": "Aurora Digital Inc.",
            "country_code": "US",
            "entity_id": "ent_7nQp3xYz",
            "entity_id_type": "derived",
            "companies": [
              {
                "source": "sec",
                "ticker": "AUR",
                "exchange": "NASDAQ",
                "lei": null,
                "entity_status": "active"
              }
            ]
          }
        ]
      },
      {
        "id": "tm_Qr6nK9jL",
        "object": "trademark",
        "mark_text": "AURORA DIGITAL",
        "status": { "primary": "active", "stage": "registered" },
        "office_code": "euipo",
        "jurisdiction_code": "EU",
        "filing_date": "2023-07-20",
        "registration_date": "2024-11-05",
        "classifications": [
          { "nice_class": 9, "goods_services_text": "Downloadable software for digital image processing" },
          { "nice_class": 42, "goods_services_text": "Software as a service (SaaS) featuring media management tools" }
        ],
        "owners": [
          {
            "id": "own_7nQp3xYz",
            "name": "Aurora Digital Inc.",
            "country_code": "US",
            "entity_id": "ent_7nQp3xYz",
            "entity_id_type": "derived"
          }
        ]
      }
    ],
    "has_more": true,
    "pagination": {
      "cursor": "eyJpZCI6ImFiYyJ9"
    },
    "request_id": "req_fY5pQ1rS"
  }
  ```
</ResponseExample>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.signa.so/v1/owners/own_R3jK9mN2/trademarks?status_stage=registered&offices=uspto,euipo&nice_classes=9,42&limit=20" \
    -H "Authorization: Bearer sig_YOUR_KEY"
  ```

  ```typescript TypeScript theme={null}
  import { Signa } from "@signa-so/sdk";

  const signa = new Signa({ api_key: process.env.SIGNA_API_KEY });

  const page = await signa.owners.trademarks("own_R3jK9mN2", {
    status_stage: ["registered"],
    offices: ["uspto", "euipo"],
    nice_classes: [9, 42],
    limit: 20,
  });
  ```
</CodeGroup>

## Errors

| Status | Type               | Description                               |
| ------ | ------------------ | ----------------------------------------- |
| 400    | `validation_error` | Invalid query parameters or date range    |
| 401    | `unauthorized`     | Missing or invalid API key                |
| 403    | `forbidden`        | API key lacks the `trademarks:read` scope |
| 404    | `not_found`        | Owner ID does not exist                   |
| 429    | `rate_limited`     | Too many requests                         |

## Related Endpoints

* [Get Owner](/api-reference/parties/get-owner): owner profile and stats
* [Owner Related](/api-reference/parties/owner-related): related entities (subsidiaries, parent companies)
* [List Trademarks](/api-reference/trademarks/list-trademarks): search across all owners