Reconcile

Diff your trademark records against Signa’s register data

POST /v1/reconcile

Reconcile

cURL

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 the trademark records you already hold against Signa’s register data and get a field-by-field diff back — nothing is stored.

Records drift from the register over time: statuses change, owners change, registration numbers get assigned, and renewal dates move. Send the fields you have and Signa tells you, per record and per field, exactly where you still match the register and where you’ve fallen out of sync. Use it to surface exceptions, run scheduled drift checks, or audit a book of matters during onboarding.

Records that aren’t found — or that match more than one register entry — come back as per-item outcomes in the response, never a request-level error.

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

Register record update timestamp as ISO 8601, or null when unresolved.

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

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

Related Endpoints

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