Reconcile

curl --request POST \
  --url https://api.signa.so/v1/reconcile \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "items": [
    {
      "office": "<string>",
      "application_number": "<string>",
      "registration_number": "<string>",
      "your_fields": {
        "status": "<string>",
        "owner_name": "<string>",
        "mark_text": "<string>",
        "filing_date": "<string>",
        "registration_date": "<string>",
        "expiry_date": "<string>",
        "renewal_due_date": "<string>",
        "registration_number": "<string>",
        "nice_classes": [
          123
        ]
      }
    }
  ]
}
'

{
  "object": "list",
  "data": [
    {
      "object": "reconciliation",
      "office": "uspto",
      "application_number": "88123456",
      "registration_number": null,
      "result": "mismatch",
      "trademark_id": "tm_018f2f1b-2f15-7d4b-9e3c-b8b5a5c9b012",
      "register_last_updated_at": "2026-07-05T12:00:00.000Z",
      "fields": [
        {
          "field": "status",
          "your_value": "active",
          "register_value": "active",
          "match": true
        },
        {
          "field": "owner_name",
          "your_value": "Nike, Inc.",
          "register_value": "Nike Innovate C.V.",
          "match": false
        }
      ],
      "mismatch_count": 1
    }
  ],
  "has_more": false,
  "pagination": { "cursor": null },
  "request_id": "req_bT9kM3nP"
}

POST

reconcile

Reconcile

curl --request POST \
  --url https://api.signa.so/v1/reconcile \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "items": [
    {
      "office": "<string>",
      "application_number": "<string>",
      "registration_number": "<string>",
      "your_fields": {
        "status": "<string>",
        "owner_name": "<string>",
        "mark_text": "<string>",
        "filing_date": "<string>",
        "registration_date": "<string>",
        "expiry_date": "<string>",
        "renewal_due_date": "<string>",
        "registration_number": "<string>",
        "nice_classes": [
          123
        ]
      }
    }
  ]
}
'

{
  "object": "list",
  "data": [
    {
      "object": "reconciliation",
      "office": "uspto",
      "application_number": "88123456",
      "registration_number": null,
      "result": "mismatch",
      "trademark_id": "tm_018f2f1b-2f15-7d4b-9e3c-b8b5a5c9b012",
      "register_last_updated_at": "2026-07-05T12:00:00.000Z",
      "fields": [
        {
          "field": "status",
          "your_value": "active",
          "register_value": "active",
          "match": true
        },
        {
          "field": "owner_name",
          "your_value": "Nike, Inc.",
          "register_value": "Nike Innovate C.V.",
          "match": false
        }
      ],
      "mismatch_count": 1
    }
  ],
  "has_more": false,
  "pagination": { "cursor": null },
  "request_id": "req_bT9kM3nP"
}

Overview

Compare your trademark matter records against Signa’s normalized register copy without persisting data. Docketing/IPMS vendors and corporate IP teams keep their own matter database, but office registers change: statuses drift, owners change, registration numbers appear later, and renewal dates move. Reconciliation diffs your fields against the register, producing the audit workflow that platforms like Equinox, Patricia, and Anaqua sell as a high-value data quality service. Use this endpoint for bulk sync checks, nightly drift reports, onboarding audits, and customer-visible exception queues. Not-found and ambiguous records are per-item outcomes in the response, not request-level failures.

Request Body

items

object[]

required

Records to reconcile, max 100 items. Results are returned in the same order, with one reconciliation per input item.

Show Item object

office

string

required

Trademark office code, e.g. uspto, euipo, or cipo. Values are normalized to lowercase.

application_number

string

Office-native application number. Provide at least one of application_number or registration_number.

registration_number

string

Office-native registration number. Provide at least one of application_number or registration_number.

your_fields

object

required

Fields from your system to compare. Must include at least one key and rejects unknown keys.

Show your_fields

status

string

Caller status value. Primary statuses compare against status_primary; stage statuses compare against status_stage; unknown values are reported as mismatches.

owner_name

string

Owner name from your system. Compared with normalized legal suffix, punctuation, case, and diacritic folding.

mark_text

string

Mark text from your system. Compared case-insensitively with collapsed whitespace.

filing_date

string

Filing date as YYYY-MM-DD.

registration_date

string

Registration date as YYYY-MM-DD.

expiry_date

string

Expiry date as YYYY-MM-DD.

renewal_due_date

string

Renewal due date as YYYY-MM-DD.

registration_number

string

Registration number to compare against the register value.

nice_classes

integer[]

Nice class numbers. Compared as a set.

Response

A standard list response with data: Reconciliation[]. Pagination is not used; data[i] corresponds to items[i].

object

string

Always list.

data

object[]

Show Reconciliation

object

string

Always reconciliation.

office

string

Office used for lookup.

application_number

string | null

Application number supplied on the input item, or null.

registration_number

string | null

Registration number supplied on the input item, or null.

result

string

One of match, mismatch, not_found, or ambiguous.

trademark_id

string | null

Signa trademark ID (tm_*) when exactly one register record resolved.

register_last_updated_at

string | null

fields

object[]

Show ReconcileFieldDiff

field

string

Compared field: status, owner_name, mark_text, filing_date, registration_date, expiry_date, renewal_due_date, registration_number, or nice_classes.

your_value

string | integer[]

Value supplied in your_fields.

register_value

string | integer[] | null

Normalized register value compared against your value.

match

boolean

Whether the field matched after field-specific normalization.

mismatch_count

integer

Number of fields[] entries where match is false.

match_count

integer

Present only for ambiguous identifier lookups; capped at 2+.

has_more

boolean

Always false.

pagination

object

Always { "cursor": null }.

request_id

string

Unique request identifier for support and debugging.

not_found is soft: the request still returns HTTP 200, with result: "not_found" for that item and an empty fields array. ambiguous means the identifier lookup resolved to more than one register record, such as an (office, application_number) pair that is not unique; Signa does not silently choose one.

{
  "object": "list",
  "data": [
    {
      "object": "reconciliation",
      "office": "uspto",
      "application_number": "88123456",
      "registration_number": null,
      "result": "mismatch",
      "trademark_id": "tm_018f2f1b-2f15-7d4b-9e3c-b8b5a5c9b012",
      "register_last_updated_at": "2026-07-05T12:00:00.000Z",
      "fields": [
        {
          "field": "status",
          "your_value": "active",
          "register_value": "active",
          "match": true
        },
        {
          "field": "owner_name",
          "your_value": "Nike, Inc.",
          "register_value": "Nike Innovate C.V.",
          "match": false
        }
      ],
      "mismatch_count": 1
    }
  ],
  "has_more": false,
  "pagination": { "cursor": null },
  "request_id": "req_bT9kM3nP"
}

Code Examples

curl "https://api.signa.so/v1/reconcile" \
  -H "Authorization: Bearer sig_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "office": "uspto",
        "application_number": "88123456",
        "your_fields": {
          "status": "active",
          "owner_name": "Nike, Inc."
        }
      }
    ]
  }'

Errors

Status	Type	Description
400	`validation_error`	Malformed body, missing identifier, empty `your_fields`, invalid date format, or unknown body field
401	`unauthorized`	Missing or invalid API key
403	`forbidden`	API key missing the `trademarks:read` scope
422	`batch_too_large`	More than 100 items. The error carries `item_count` and `item_count_limit`
429	`rate_limited`	Too many requests

Batch Get Trademarks — hydrate known IDs or office-native identifiers
List Trademarks — search the normalized register

Suggest Goods & Services Get Current Organization

​Overview

​Request Body

​Response

​Code Examples

​Errors

​Related Endpoints

Overview

Request Body

Response

Code Examples

Errors

Related Endpoints