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

# Trademark Assignments

> List recorded transfers, liens, and releases for one trademark

## When To Use This

Use this endpoint when M\&A counsel or diligence teams need the recorded chain of title for one mark before an acquisition. It shows assignments, security interests, releases, and other recorded conveyances for the mark, so unreleased liens can be spotted before closing.

For the cross-mark diligence workflow, see [Chain-of-title & Lien Diligence](/guides/chain-of-title-lien-diligence).

## Path Parameters

<ParamField path="id" type="string" required>
  Trademark ID (`tm_...`).
</ParamField>

## Query Parameters

<ParamField query="conveyance_type" type="string">
  Filter by conveyance type. One of `assignment`, `security_interest`, `release`, `merger`, `name_change`, `license`, `partial_assignment`, `correction`, `entity_conversion`, `other`.
</ParamField>

<ParamField query="type" type="string">
  Alias for `conveyance_type`.
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Page size (1-100).
</ParamField>

<ParamField query="cursor" type="string">
  Pagination cursor from a previous response.
</ParamField>

## Response

<ResponseField name="data" type="object[]">
  Assignment records for this trademark, sorted by `recorded_date` descending.
</ResponseField>

Each item carries the assignment summary fields plus `correspondent`, `parties`, and `properties`. `parties[]` includes `role`, `name`, `owner_id`, `execution_date`, `date_acknowledged`, `legal_entity_text`, `nationality`, and `address` (a pass-through object of the office-provided party address fields, or `null`). `properties[]` includes the affected `trademark_id`, office serial and registration numbers, international registration number, and mark name.

## Example Request

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.signa.so/v1/trademarks/tm_11111111-1111-4111-8111-111111111111/assignments" \
    -H "Authorization: Bearer $SIGNA_API_KEY"
  ```
</RequestExample>

## Example Response

<ResponseExample>
  ```json theme={null}
  {
    "object": "list",
    "data": [
      {
        "id": "asg_77777777-7777-4777-8777-777777777777",
        "object": "assignment",
        "reel_no": "9120",
        "frame_no": "0301",
        "conveyance_type": "release",
        "conveyance_text": "RELEASE OF SECURITY INTEREST",
        "recorded_date": "2025-04-18",
        "last_update_date": "2025-04-22",
        "page_count": 3,
        "release_of_reel_no": "9102",
        "release_of_frame_no": "0100",
        "created_at": "2025-04-18T14:30:00.000Z",
        "updated_at": "2025-04-22T18:45:00.000Z",
        "correspondent": {
          "name": "Loan Collateral Services",
          "address1": "500 Delaware Avenue, Suite 720",
          "address2": "Wilmington, DE 19801"
        },
        "parties": [
          {
            "role": "assignee",
            "name": "Northstar Brands LLC",
            "owner_id": "own_22222222-2222-4222-8222-222222222222",
            "execution_date": "2025-04-10",
            "date_acknowledged": null,
            "legal_entity_text": "corporation",
            "nationality": "US",
            "address": {
              "address1": "88 Harbor Point Road",
              "city": "Stamford",
              "state": "CT",
              "postcode": "06902"
            }
          },
          {
            "role": "assignor",
            "name": "First Continental Bank, N.A.",
            "owner_id": "own_44444444-4444-4444-8444-444444444444",
            "execution_date": "2025-04-10",
            "date_acknowledged": "2025-04-11",
            "legal_entity_text": "corporation",
            "nationality": "US",
            "address": null
          }
        ],
        "properties": [
          {
            "trademark_id": "tm_11111111-1111-4111-8111-111111111111",
            "serial_no": "98887777",
            "registration_no": "6543210",
            "intl_reg_no": null,
            "mark_name": "NORTHSTAR SUPPLY"
          }
        ]
      },
      {
        "id": "asg_66666666-6666-4666-8666-666666666666",
        "object": "assignment",
        "reel_no": "9102",
        "frame_no": "0100",
        "conveyance_type": "security_interest",
        "conveyance_text": "SECURITY INTEREST",
        "recorded_date": "2024-10-03",
        "last_update_date": "2024-10-07",
        "page_count": 4,
        "release_of_reel_no": null,
        "release_of_frame_no": null,
        "created_at": "2024-10-03T14:30:00.000Z",
        "updated_at": "2024-10-07T18:45:00.000Z",
        "correspondent": {
          "name": "Loan Collateral Services",
          "address1": "500 Delaware Avenue, Suite 720",
          "address2": "Wilmington, DE 19801"
        },
        "parties": [
          {
            "role": "assignee",
            "name": "First Continental Bank, N.A.",
            "owner_id": "own_44444444-4444-4444-8444-444444444444",
            "execution_date": "2024-09-30",
            "date_acknowledged": null,
            "legal_entity_text": "corporation",
            "nationality": "US",
            "address": {
              "address1": "1 Financial Plaza",
              "city": "Hartford",
              "state": "CT",
              "postcode": "06103"
            }
          },
          {
            "role": "assignor",
            "name": "Northstar Brands LLC",
            "owner_id": "own_22222222-2222-4222-8222-222222222222",
            "execution_date": "2024-09-30",
            "date_acknowledged": "2024-10-01",
            "legal_entity_text": "corporation",
            "nationality": "US",
            "address": null
          }
        ],
        "properties": [
          {
            "trademark_id": "tm_11111111-1111-4111-8111-111111111111",
            "serial_no": "98887777",
            "registration_no": "6543210",
            "intl_reg_no": null,
            "mark_name": "NORTHSTAR SUPPLY"
          }
        ]
      }
    ],
    "has_more": false,
    "pagination": {
      "cursor": null
    },
    "request_id": "req_test_fixed"
  }
  ```
</ResponseExample>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.signa.so/v1/trademarks/tm_11111111-1111-4111-8111-111111111111/assignments?type=security_interest" \
    -H "Authorization: Bearer sig_YOUR_KEY_HERE"
  ```

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

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

  const chain = await signa.trademarks.assignments(
    "tm_11111111-1111-4111-8111-111111111111",
    { type: "security_interest" },
  );
  ```

  ```python Python theme={null}
  import requests

  resp = requests.get(
      "https://api.signa.so/v1/trademarks/tm_11111111-1111-4111-8111-111111111111/assignments",
      headers={"Authorization": "Bearer sig_YOUR_KEY_HERE"},
      params={"type": "security_interest"},
  )
  ```
</CodeGroup>

## Errors

| Status | Type               | Description                             |
| ------ | ------------------ | --------------------------------------- |
| 400    | `validation_error` | Invalid trademark ID or query parameter |
| 401    | `unauthorized`     | Missing or invalid API key              |
| 403    | `forbidden`        | Missing `trademarks:read` scope         |
| 404    | `not_found`        | Trademark not found                     |
| 429    | `rate_limited`     | Too many requests                       |

## Related Endpoints

* [List Assignments](/api-reference/records/transactions/list-assignments): filter recorded transactions across marks
* [Get Assignment](/api-reference/records/transactions/get-assignment): retrieve parties and affected marks for one transaction
* [Chain-of-title & Lien Diligence](/guides/chain-of-title-lien-diligence): owner and mark diligence workflow
