> ## Documentation Index
> Fetch the complete documentation index at: https://docs.signa.so/llms.txt
> Use this file to discover all available pages before exploring further.
# Reconcile
> Diff your trademark records against Signa's register data
## 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
Records to reconcile, max 100 items. Results are returned in the same order, with one `reconciliation` per input item.
Trademark office code, e.g. `uspto`, `euipo`, or `cipo`. Values are normalized to lowercase.
Office-native application number. Provide at least one of `application_number` or `registration_number`.
Office-native registration number. Provide at least one of `application_number` or `registration_number`.
Fields from your system to compare. Must include at least one key and rejects unknown keys.
Caller status value. Primary statuses compare against `status_primary`; stage statuses compare against `status_stage`; unknown values are reported as mismatches.
Owner name from your system. Compared with normalized legal suffix, punctuation, case, and diacritic folding.
Mark text from your system. Compared case-insensitively with collapsed whitespace.
Filing date as `YYYY-MM-DD`.
Registration date as `YYYY-MM-DD`.
Expiry date as `YYYY-MM-DD`.
Renewal due date as `YYYY-MM-DD`.
Registration number to compare against the register value.
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]`.
Always `list`.
Always `reconciliation`.
Office used for lookup.
Application number supplied on the input item, or `null`.
Registration number supplied on the input item, or `null`.
One of `match`, `mismatch`, `not_found`, or `ambiguous`.
Signa trademark ID (`tm_*`) when exactly one register record resolved.
Register record update timestamp as ISO 8601, or `null` when unresolved.
Compared field: `status`, `owner_name`, `mark_text`, `filing_date`, `registration_date`, `expiry_date`, `renewal_due_date`, `registration_number`, or `nice_classes`.
Value supplied in `your_fields`.
Normalized register value compared against your value.
Whether the field matched after field-specific normalization.
Number of `fields[]` entries where `match` is `false`.
Present only for ambiguous identifier lookups; capped at `2+`.
Always `false`.
Always `{ "cursor": null }`.
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.
```json theme={null}
{
"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
```bash cURL theme={null}
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."
}
}
]
}'
```
```typescript TypeScript SDK theme={null}
import { Signa } from "@signa-so/sdk";
const signa = new Signa({ api_key: "sig_xxxxxxxxxxxx" });
const results = await signa.reconcile.run({
items: [{ office: 'uspto', application_number: '88123456', your_fields: { status: 'active', owner_name: 'Nike, Inc.' } }]
});
for (const result of results.data) {
console.log(result.result, result.mismatch_count);
}
```
```python Python theme={null}
import requests
resp = requests.post(
"https://api.signa.so/v1/reconcile",
headers={
"Authorization": "Bearer sig_xxxxxxxxxxxx",
"Content-Type": "application/json",
},
json={
"items": [
{
"office": "uspto",
"application_number": "88123456",
"your_fields": {
"status": "active",
"owner_name": "Nike, Inc.",
},
}
]
},
)
for result in resp.json()["data"]:
print(result["result"], result["mismatch_count"])
```
## 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](/api-reference/trademarks/batch-trademarks) -- hydrate known IDs or office-native identifiers
* [List Trademarks](/api-reference/trademarks/list-trademarks) -- search the normalized register