Get Assignment

Retrieve one recorded trademark transaction with parties and affected marks

GET /v1/assignments/{id}

cURL

curl "https://api.signa.so/v1/assignments/asg_cacc6877-1e78-4290-9c5d-1b5c4ef832f7" \
  -H "Authorization: Bearer $SIGNA_API_KEY"

{
  "id": "asg_cacc6877-1e78-4290-9c5d-1b5c4ef832f7",
  "object": "assignment",
  "reel_no": "9252",
  "frame_no": "0333",
  "conveyance_type": "security_interest",
  "conveyance_text": "SECURITY INTEREST",
  "recorded_date": "2026-04-30",
  "last_update_date": "2026-07-07",
  "page_count": 15,
  "release_of_reel_no": null,
  "release_of_frame_no": null,
  "created_at": "2026-07-09T06:29:56.742Z",
  "updated_at": "2026-07-09T06:29:56.742Z",
  "correspondent": {
    "name": "Beth Frankenfield",
    "address1": "1735 Market Street 51st Fl.",
    "address2": "Philadelphia, PA 19103"
  },
  "parties": [
    {
      "role": "assignee",
      "name": "PNC BANK, NATIONAL ASSOCIATION",
      "owner_id": null,
      "execution_date": null,
      "date_acknowledged": null,
      "legal_entity_text": "NATIONAL BANKING ASSOCIATION",
      "nationality": "UNITED STATES",
      "address": {
        "address1": "1600 MARKET STREET",
        "city": "PHILADELPHIA",
        "state": "PENNSYLVANIA",
        "postcode": "19103"
      }
    },
    {
      "role": "assignor",
      "name": "PMC BIOGENIX (KOREA) LTD.",
      "owner_id": null,
      "execution_date": "2026-04-24",
      "date_acknowledged": null,
      "legal_entity_text": "CORPORATION",
      "nationality": "KOREA, REPUBLIC OF",
      "address": null
    }
  ],
  "properties": [
    {
      "trademark_id": null,
      "serial_no": "98352651",
      "registration_no": "7806315",
      "intl_reg_no": null,
      "mark_name": "ARMOSLIP"
    }
  ],
  "request_id": "req_01kx2v1xdwhpsazba6p3effxm9"
}

When To Use This

Use this endpoint when you already have an assignment ID and need the full parties plus affected marks for one recorded transaction. A diligence team can pull a security-interest record to identify the borrower, lender, execution date, reel/frame, and every trademark covered by the filing.

For release pairing across a mark or owner, see Chain-of-title & Lien Diligence.

Path Parameters

id · string · required

Assignment ID (asg_...).

Response

id · string

Assignment ID (asg_...).

object · string

Always assignment.

reel_no · string

USPTO assignment reel number.

frame_no · string

USPTO assignment frame number.

conveyance_type · string

Normalized conveyance type, such as assignment, security_interest, or release.

conveyance_text · string

Office conveyance text.

recorded_date · string | null

Date the transaction was recorded.

last_update_date · string | null

Date the source office last updated this assignment record.

page_count · integer | null

Number of pages in the recorded assignment document, when known.

release_of_reel_no · string | null

Reel number released by this record, when the conveyance is a release.

release_of_frame_no · string | null

Frame number released by this record, when the conveyance is a release.

correspondent · object | null

Correspondent payload from the assignment record, when available. A pass-through object of the office-provided fields — a name plus address fields such as address1–address4 (which keys are present varies by record).

parties · object[]

Parties to the recorded transaction. Each party has role, name, owner_id, execution_date, date_acknowledged, legal_entity_text, nationality, and address. address is a pass-through object of the office-provided party address fields (such as address1–address2, city, state, postcode), or null when the office recorded none. date_acknowledged is the date the party acknowledged the conveyance, or null.

properties · object[]

Affected trademark records. Each property has trademark_id, serial_no, registration_no, intl_reg_no, and mark_name.

created_at · string

ISO timestamp for when Signa created the assignment record.

updated_at · string

ISO timestamp for the latest Signa update to the assignment record.

Example Request

cURL

curl "https://api.signa.so/v1/assignments/asg_cacc6877-1e78-4290-9c5d-1b5c4ef832f7" \
  -H "Authorization: Bearer $SIGNA_API_KEY"

Example Response

{
  "id": "asg_cacc6877-1e78-4290-9c5d-1b5c4ef832f7",
  "object": "assignment",
  "reel_no": "9252",
  "frame_no": "0333",
  "conveyance_type": "security_interest",
  "conveyance_text": "SECURITY INTEREST",
  "recorded_date": "2026-04-30",
  "last_update_date": "2026-07-07",
  "page_count": 15,
  "release_of_reel_no": null,
  "release_of_frame_no": null,
  "created_at": "2026-07-09T06:29:56.742Z",
  "updated_at": "2026-07-09T06:29:56.742Z",
  "correspondent": {
    "name": "Beth Frankenfield",
    "address1": "1735 Market Street 51st Fl.",
    "address2": "Philadelphia, PA 19103"
  },
  "parties": [
    {
      "role": "assignee",
      "name": "PNC BANK, NATIONAL ASSOCIATION",
      "owner_id": null,
      "execution_date": null,
      "date_acknowledged": null,
      "legal_entity_text": "NATIONAL BANKING ASSOCIATION",
      "nationality": "UNITED STATES",
      "address": {
        "address1": "1600 MARKET STREET",
        "city": "PHILADELPHIA",
        "state": "PENNSYLVANIA",
        "postcode": "19103"
      }
    },
    {
      "role": "assignor",
      "name": "PMC BIOGENIX (KOREA) LTD.",
      "owner_id": null,
      "execution_date": "2026-04-24",
      "date_acknowledged": null,
      "legal_entity_text": "CORPORATION",
      "nationality": "KOREA, REPUBLIC OF",
      "address": null
    }
  ],
  "properties": [
    {
      "trademark_id": null,
      "serial_no": "98352651",
      "registration_no": "7806315",
      "intl_reg_no": null,
      "mark_name": "ARMOSLIP"
    }
  ],
  "request_id": "req_01kx2v1xdwhpsazba6p3effxm9"
}

Code Examples

cURL

curl "https://api.signa.so/v1/assignments/asg_cacc6877-1e78-4290-9c5d-1b5c4ef832f7" \
  -H "Authorization: Bearer sig_YOUR_KEY_HERE"

import { Signa } from "@signa-so/sdk";

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

const assignment = await signa.assignments.retrieve(
  "asg_cacc6877-1e78-4290-9c5d-1b5c4ef832f7",
);

import requests

resp = requests.get(
    "https://api.signa.so/v1/assignments/asg_cacc6877-1e78-4290-9c5d-1b5c4ef832f7",
    headers={"Authorization": "Bearer sig_YOUR_KEY_HERE"},
)

Errors

Status	Type	Description
400	validation_error	Invalid assignment ID
401	unauthorized	Missing or invalid API key
403	forbidden	Missing trademarks:read scope
404	not_found	Assignment not found
429	rate_limited	Too many requests

Related Endpoints

• List Assignments: find recorded transactions by owner, entity, trademark, or type
• Trademark Assignments: chain of title for one mark
• Chain-of-title & Lien Diligence: pair security interests with releases