Retrieve Assignment

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",
  "office_code": "US",
  "reel_number": "9252",
  "frame_number": "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_number": null,
  "release_of_frame_number": null,
  "release_match": 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",
      "country_code": "US",
      "address": {
        "lines": ["1600 MARKET STREET"],
        "city": "PHILADELPHIA",
        "region": "PENNSYLVANIA",
        "postal_code": "19103",
        "country_code": "US",
        "formatted": null
      }
    },
    {
      "role": "assignor",
      "name": "PMC BIOGENIX (KOREA) LTD.",
      "owner_id": null,
      "execution_date": "2026-04-24",
      "date_acknowledged": null,
      "legal_entity_text": "CORPORATION",
      "country_code": "KR",
      "address": null
    }
  ],
  "properties": [
    {
      "trademark_id": null,
      "application_number": "98352651",
      "registration_number": "7806315",
      "ir_number": null,
      "mark_text": "ARMOSLIP"
    }
  ],
  "request_id": "req_01kx2v1xdwhpsazba6p3effxm9"
}

GET

assignments

{id}

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",
  "office_code": "US",
  "reel_number": "9252",
  "frame_number": "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_number": null,
  "release_of_frame_number": null,
  "release_match": 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",
      "country_code": "US",
      "address": {
        "lines": ["1600 MARKET STREET"],
        "city": "PHILADELPHIA",
        "region": "PENNSYLVANIA",
        "postal_code": "19103",
        "country_code": "US",
        "formatted": null
      }
    },
    {
      "role": "assignor",
      "name": "PMC BIOGENIX (KOREA) LTD.",
      "owner_id": null,
      "execution_date": "2026-04-24",
      "date_acknowledged": null,
      "legal_entity_text": "CORPORATION",
      "country_code": "KR",
      "address": null
    }
  ],
  "properties": [
    {
      "trademark_id": null,
      "application_number": "98352651",
      "registration_number": "7806315",
      "ir_number": null,
      "mark_text": "ARMOSLIP"
    }
  ],
  "request_id": "req_01kx2v1xdwhpsazba6p3effxm9"
}

Credits: 1 per record.

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

string

required

Assignment ID (asg_...).

Response

string

Assignment ID (asg_...).

string

Always assignment.

string

Office that recorded the transaction (WIPO ST.3, US today).

string

USPTO assignment reel number.

string

USPTO assignment frame number.

string

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

string

Office conveyance text.

string | null

Date the transaction was recorded.

string | null

Date the source office last updated this assignment record.

integer | null

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

string | null

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

string | null

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

string | null

For a security interest, pointer when a release cites this record’s reel and frame: in its release_of_* fields, or in its text (such as RECORDED AT R/F 8272/0621) when the release also covers one of this record’s marks. null when no release cites it, and always null for other conveyance types. Most USPTO releases cite no reel/frame; Signa does not pair those yet (pairing them by lender, borrower and mark is planned), so null does not prove the lien is still open.

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

object[]

Parties to the recorded transaction. Each party has role, name, owner_id, execution_date, date_acknowledged, legal_entity_text, country_code (ISO 3166-1 alpha-2, null when the office named no country; it was nationality before the provenance release) and address. address is the one address shape (lines[], city, region, postal_code, country_code, formatted), or null when the office recorded none. date_acknowledged is the date the party acknowledged the conveyance, or null.

object[]

Affected trademark records. Each property has trademark_id, application_number, registration_number, ir_number, and mark_text (they were serial_no, registration_no, intl_reg_no and mark_name before the provenance release).

string

ISO timestamp for when Signa created the assignment record.

string

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

Example Request

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",
  "office_code": "US",
  "reel_number": "9252",
  "frame_number": "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_number": null,
  "release_of_frame_number": null,
  "release_match": 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",
      "country_code": "US",
      "address": {
        "lines": ["1600 MARKET STREET"],
        "city": "PHILADELPHIA",
        "region": "PENNSYLVANIA",
        "postal_code": "19103",
        "country_code": "US",
        "formatted": null
      }
    },
    {
      "role": "assignor",
      "name": "PMC BIOGENIX (KOREA) LTD.",
      "owner_id": null,
      "execution_date": "2026-04-24",
      "date_acknowledged": null,
      "legal_entity_text": "CORPORATION",
      "country_code": "KR",
      "address": null
    }
  ],
  "properties": [
    {
      "trademark_id": null,
      "application_number": "98352651",
      "registration_number": "7806315",
      "ir_number": null,
      "mark_text": "ARMOSLIP"
    }
  ],
  "request_id": "req_01kx2v1xdwhpsazba6p3effxm9"
}

Code Examples

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"},
)

Search 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

Overview

Trademarks

Parties

Records

Intelligence

Filing & docketing

Monitoring

Analytics

Reference

Administration

SDK

When To Use This

Path Parameters

Response

Example Request

Example Response

Code Examples

​When To Use This

​Path Parameters

​Response

​Example Request

​Example Response

​Code Examples

​Related Endpoints

When To Use This

Path Parameters

Response

Example Request

Example Response

Code Examples

Related Endpoints