Skip to main content
GET
/
v1
/
assignments
curl -G "https://api.signa.so/v1/assignments" \
  -H "Authorization: Bearer $SIGNA_API_KEY" \
  --data-urlencode "owner_id=own_019f20b5-0a66-76c2-968e-d35f9eb1eb87" \
  --data-urlencode "type=security_interest" \
  --data-urlencode "recorded_date_gte=2026-04-27" \
  --data-urlencode "recorded_date_lt=2026-04-28" \
  --data-urlencode "limit=20"

{
  "object": "list",
  "data": [
    {
      "id": "asg_15b6d53f-3dfd-4714-8623-e369d0f2aad6",
      "object": "assignment",
      "reel_no": "9248",
      "frame_no": "0297",
      "conveyance_type": "security_interest",
      "conveyance_text": "SECURITY INTEREST",
      "recorded_date": "2026-04-27",
      "last_update_date": "2026-06-30",
      "page_count": 6,
      "release_of_reel_no": null,
      "release_of_frame_no": null,
      "created_at": "2026-07-09T06:29:33.527Z",
      "updated_at": "2026-07-09T06:29:33.527Z"
    }
  ],
  "has_more": false,
  "pagination": {
    "cursor": null
  },
  "request_id": "req_01kx3pgq4xmn84ze3g8ydreag9"
}

​
When To Use This

Use this endpoint when a brand-transaction analyst, lender, or counsel needs to filter recorded transfers and security interests across an owner or corporate family. For example, a lender checking existing liens before brand-backed lending can replace a manual UCC plus USPTO dual search with owner_id or entity_id plus type=security_interest. This endpoint always requires a filter and is never a firehose. For an end-to-end workflow, see Chain-of-title & Lien Diligence.

​
Query Parameters

At least one of owner_id, entity_id, trademark_id, conveyance_type, type, recorded_date_gte, recorded_date_lt, or role must be supplied.
​
owner_id
string
Filter by resolved owner ID (own_...). Matches assignments where the owner appears as any party unless role is also supplied.
​
entity_id
string
Filter by resolved entity ID (ent_...) across member owner records.
​
trademark_id
string
Filter by affected trademark ID (tm_...).
​
conveyance_type
string
Comma-separated conveyance types. Allowed values: assignment, security_interest, release, merger, name_change, license, partial_assignment, correction, entity_conversion, other.
​
type
string
Alias for conveyance_type. Use either type or conveyance_type, not both.
​
recorded_date_gte
string
Recorded date >= (YYYY-MM-DD).
​
recorded_date_lt
string
Recorded date < (YYYY-MM-DD). Must be after recorded_date_gte.
​
role
string
Filter by party role. One of assignor, assignee.
​
sort
string
default:"-recorded_date"
Sort order. One of -recorded_date, recorded_date.
​
limit
integer
default:"20"
Page size (1-100).
​
cursor
string
Pagination cursor from a previous response.

​
Response

​
data
object[]
Array of assignment summary records.
Each item carries id, object, reel_no, frame_no, conveyance_type, conveyance_text, recorded_date, last_update_date, page_count, release_of_reel_no, release_of_frame_no, created_at, and updated_at. Use Get Assignment when you need parties and affected marks.

​
Example Request

curl -G "https://api.signa.so/v1/assignments" \
  -H "Authorization: Bearer $SIGNA_API_KEY" \
  --data-urlencode "owner_id=own_019f20b5-0a66-76c2-968e-d35f9eb1eb87" \
  --data-urlencode "type=security_interest" \
  --data-urlencode "recorded_date_gte=2026-04-27" \
  --data-urlencode "recorded_date_lt=2026-04-28" \
  --data-urlencode "limit=20"

​
Example Response

{
  "object": "list",
  "data": [
    {
      "id": "asg_15b6d53f-3dfd-4714-8623-e369d0f2aad6",
      "object": "assignment",
      "reel_no": "9248",
      "frame_no": "0297",
      "conveyance_type": "security_interest",
      "conveyance_text": "SECURITY INTEREST",
      "recorded_date": "2026-04-27",
      "last_update_date": "2026-06-30",
      "page_count": 6,
      "release_of_reel_no": null,
      "release_of_frame_no": null,
      "created_at": "2026-07-09T06:29:33.527Z",
      "updated_at": "2026-07-09T06:29:33.527Z"
    }
  ],
  "has_more": false,
  "pagination": {
    "cursor": null
  },
  "request_id": "req_01kx3pgq4xmn84ze3g8ydreag9"
}

​
Code Examples

curl "https://api.signa.so/v1/assignments?owner_id=own_019f20b5-0a66-76c2-968e-d35f9eb1eb87&type=security_interest&limit=20" \
  -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 liens = await signa.assignments.list({
  owner_id: "own_019f20b5-0a66-76c2-968e-d35f9eb1eb87",
  type: "security_interest",
  limit: 20,
});

import requests

resp = requests.get(
    "https://api.signa.so/v1/assignments",
    headers={"Authorization": "Bearer sig_YOUR_KEY_HERE"},
    params={
        "owner_id": "own_019f20b5-0a66-76c2-968e-d35f9eb1eb87",
        "type": "security_interest",
        "limit": 20,
    },
)

​
Errors

StatusTypeDescription
400validation_errorNo filter supplied, invalid date range, unsupported parameter, or both type and conveyance_type supplied
401unauthorizedMissing or invalid API key
403forbiddenMissing trademarks:read scope
422entity_too_largeentity_id resolved to more member owners than the cap
429rate_limitedToo many requests