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"
}
Assignments
Search Assignments
Search recorded trademark transfers, liens, and releases
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 withowner_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 ofowner_id, entity_id, trademark_id, conveyance_type, type, recorded_date_gte, recorded_date_lt, or role must be supplied.
string
Filter by resolved owner ID (
own_...). Matches assignments where the owner appears as any party unless role is also supplied.string
Filter by resolved entity ID (
ent_...) across member owner records.string
Filter by affected trademark ID (
tm_...).string
Comma-separated conveyance types. Allowed values:
assignment, security_interest, release, merger, name_change, license, partial_assignment, correction, entity_conversion, other.string
Alias for
conveyance_type. Use either type or conveyance_type, not both.string
Recorded date >= (YYYY-MM-DD).
string
Recorded date < (YYYY-MM-DD). Must be after
recorded_date_gte.string
Filter by party role. One of
assignor, assignee.string
default:"-recorded_date"
Sort order. One of
-recorded_date, recorded_date.integer
default:"20"
Page size (1-100).
string
Pagination cursor from a previous response.
Response
object[]
Array of assignment summary records.
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 Retrieve 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
| Status | Type | Description |
|---|---|---|
| 400 | validation_error | No filter supplied, invalid date range, unsupported parameter, or both type and conveyance_type supplied |
| 401 | unauthorized | Missing or invalid API key |
| 403 | forbidden | Missing trademarks:read scope |
| 422 | entity_too_large | entity_id resolved to more member owners than the cap |
| 429 | rate_limited | Too many requests |
Related Endpoints
- Retrieve Assignment: full parties and affected marks for one transaction
- Trademark Assignments: chain of title for one mark
- Chain-of-title & Lien Diligence: recipe for owner, lien, and release checks