@signa-so/sdk 0.16.0 → 0.21.0

package/dist/generated/api-types.d.ts

@@ -384,7 +384,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** @description List the office event codes Signa has catalogued and the canonical `event_type` each maps to. The catalogue covers IP Australia (`AU`) and WIPO (`WO`) today; any other office returns an empty list, and its trademark events still carry their own `raw` code and label. `raw` is the office's verbatim code and label, as on a trademark event's `raw` (label null when we hold no verbatim office label for the code; every WIPO label is null because the catalogue's WIPO wording is Signa's). */
+        /** @description List the office event codes Signa has catalogued and the canonical `event_type` each maps to. The catalogue covers the USPTO (`US`), IP Australia (`AU`) and WIPO (`WO`) today; any other office returns an empty list, and its trademark events still carry their own `raw` code and label. `raw` is the office's verbatim code and label, as on a trademark event's `raw` (label null when we hold no verbatim office label for the code; every WIPO label is null because the catalogue's WIPO wording is Signa's). */
         get: operations["listEventTypes"];
         put?: never;
         post?: never;
@@ -541,14 +541,14 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * @description GET variant of trademark search/list. Same multi-strategy search as POST, with flat query params.
+         * @description GET variant of trademark search/list. Same search as POST, with flat query params.
          *
          *     Credits: 10 per page.
          */
         get: operations["listTrademarks"];
         put?: never;
         /**
-         * @description Multi-strategy text and phonetic search with faceted aggregations and relevance scoring. When query is omitted, acts as a filtered list (requires at least one filter). When sort is specified with query, relevance_score is null and rescore is disabled.
+         * @description Trademark search: q ranks marks through the similarity channels, filters (filters.mark_text included) decide which marks qualify, exclude removes marks, with faceted aggregations. Without q, acts as a filtered list (requires a filter or a mark_text operator). relevance_score is present on every hit whenever there is a q, whatever the sort.
          *
          *     Credits: 10 per page.
          */
@@ -891,7 +891,7 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * @description List related owners via GLEIF corporate hierarchy (parent/child relationships).
+         * @description List related owners via the GLEIF corporate hierarchy (parent/child relationships) of the `lei` GET /v1/owners/{id} shows: the owner's own first GLEIF LEI, else its entity's.
          *
          *     Credits: 1 per page.
          */
@@ -1122,7 +1122,7 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * @description List an entity's trademarks (summary tier) across ALL member owners, with full Appendix A filter support. Identical to GET /v1/owners/{id}/trademarks per-member, fanned across the entity's members. Rate class: search.
+         * @description List an entity's trademarks (summary tier): every mark whose owner is linked to the entity, with full Appendix A filter support. Scoped exactly like GET /v1/trademarks?entity_id= (the same resolved entity ids, no member-owner cap), so both return the same set for the same entity; the difference is that a missing entity is a 404 here and an empty page there. Rate class: search.
          *
          *     Credits: 10 per page.
          */
@@ -1164,7 +1164,7 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * @description List proceedings across all trademarks. At least one filter is required.
+         * @description List proceedings across all trademarks. At least one filter is required. Proceedings are served only for offices whose `capabilities.proceedings` on `GET /v1/offices` is `available`; an `office_code` naming any other live office returns 422 `capability_not_available` without running a query or charging credits.
          *
          *     Credits: 1 per page.
          */
@@ -1185,7 +1185,7 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * @description Retrieve a single proceeding by ID, including parent trademark summary.
+         * @description Retrieve a single proceeding by ID, including parent trademark summary. A proceeding on a mark of an office whose `capabilities.proceedings` is not `available` is not served (404).
          *
          *     Credits: 1 per record.
          */
@@ -1924,7 +1924,7 @@ export interface paths {
         get: operations["listWebhookEndpoints"];
         put?: never;
         /**
-         * @description Create a webhook endpoint. The signing secret is returned ONCE in the response — store it securely and verify HMAC signatures against it. Subsequent GET responses redact the secret. trademark.status_changed and office_action.issued are emitted only for marks in an organization portfolio; alert.created follows watch scope. An organization that monitors a mark only through watches receives alert.created, but no direct trademark event.
+         * @description Create a webhook endpoint. The signing secret is returned ONCE in the response. Store it securely and verify HMAC signatures against it. Subsequent GET responses redact the secret. trademark.status_changed, trademark.corrected and office_action.issued are emitted only for marks in an organization portfolio; alert.created follows watch scope. An organization that monitors a mark only through watches receives alert.created, but no direct trademark event. An endpoint subscribed to trademark.status_changed also receives trademark.corrected, a correction of a status Signa published earlier.
          *
          *     This operation requires an `Idempotency-Key` header (see parameter description for 24h replay and 409-conflict semantics).
          *
@@ -1957,7 +1957,7 @@ export interface paths {
         options?: never;
         head?: never;
         /**
-         * @description Update a webhook endpoint. trademark.status_changed and office_action.issued are emitted only for marks in an organization portfolio; alert.created follows watch scope. An organization that monitors a mark only through watches receives alert.created, but no direct trademark event.
+         * @description Update a webhook endpoint. trademark.status_changed, trademark.corrected and office_action.issued are emitted only for marks in an organization portfolio; alert.created follows watch scope. An organization that monitors a mark only through watches receives alert.created, but no direct trademark event. An endpoint subscribed to trademark.status_changed also receives trademark.corrected, a correction of a status Signa published earlier.
          *
          *     This operation requires an `Idempotency-Key` header (see parameter description for 24h replay and 409-conflict semantics).
          *
@@ -2422,7 +2422,7 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * @description Change the organization's live subscription to another plan or billing interval. Internal (dashboard BFF); requires organization:manage. An upgrade (or a longer interval) is invoiced now with proration and applied only once that invoice is paid — a declined payment leaves the current plan in place and returns the invoice to pay (`pending_payment`). A downgrade (or a shorter interval) is scheduled for the end of the current period (`scheduled`). Organizations without a live subscription subscribe through POST /v1/organization/billing/checkout instead.
+         * @description Change the organization's live subscription to another plan or billing interval. Internal (dashboard BFF); requires organization:manage. An upgrade (or a longer interval) is invoiced now with proration and applied only once that invoice is paid — a declined payment leaves the current plan in place and returns the invoice to pay (`pending_payment`). A downgrade (or a shorter interval) is scheduled for the end of the current period (`scheduled`). While a change made here is scheduled, requesting the current plan and interval undoes it (`applied`, nothing is charged), another period-end change replaces it, an upgrade is refused until it is undone, and repeating it answers the same `scheduled`. With `undo_scheduled_change`, the request only ever undoes that change and is refused once it is no longer pending. Organizations without a live subscription subscribe through POST /v1/organization/billing/checkout instead.
          *
          *     This operation requires an `Idempotency-Key` header (see parameter description for 24h replay and 409-conflict semantics).
          */
@@ -2557,6 +2557,12 @@ export interface components {
              */
             stage: string;
             reason: string | null;
+            /**
+             * @description Pending challenges against the record. On an IR family row, the de-duplicated union across its designations.
+             * @example [
+             *       "opposition_pending"
+             *     ]
+             */
             challenges: string[];
             /**
              * @description Office-reported date when the current status took effect, when available.
@@ -2630,6 +2636,29 @@ export interface components {
              */
             formatted: string | null;
         } | null;
+        DerivedTerm: {
+            /**
+             * @description Where the term on record stands at `as_of_date`. `in_term`: the term runs to `derived.expiry_date`, and its renewal is not past due (the due date itself, moved off a weekend or holiday, is still on time). `in_grace`: the term ended and the renewal can still be filed late, until `grace_expiry_date`. `in_restoration`: the grace period passed and the jurisdiction's restoration window is open, until `restoration_expiry_date`. `renewal_not_on_record`: the term end the office stated, its grace period and any restoration window have passed with no renewal of that term on record, so no later term is computed. The mark may have lapsed, or a renewal may not have reached the office record or Signa yet; `status` stays what the office reports. `not_applicable`: no registered term to assess: an application or another status that is not registered (`unknown` included), a dead mark, a record with no renewal rule (a US designation under the Madrid Protocol, renewed at WIPO), or no schedule computed. An `expired` mark is assessed only while it can still be renewed or restored, a `cancelled` one only while it can be restored. Treat the vocabulary as open.
+             * @example in_term
+             * @enum {string}
+             */
+            state: "in_term" | "in_grace" | "in_restoration" | "renewal_not_on_record" | "not_applicable";
+            /**
+             * @description The last day of the grace period of the term ending at `derived.expiry_date`, as its renewal row serves it. Null when `state` is `not_applicable`.
+             * @example 2035-07-20
+             */
+            grace_expiry_date: string | null;
+            /**
+             * @description The last day of the restoration window after that grace period, once the term has ended (`state` is `in_grace` or later), where the jurisdiction provides one (for example GB, EU, SG, JP, IN, IS). Null otherwise.
+             * @example null
+             */
+            restoration_expiry_date: string | null;
+            /**
+             * @description Whether a renewal on record began the term ending at `derived.expiry_date`, that is, renewed the term before it: the office states a term end past the first term, the office recorded that renewal (for the USPTO, accepted the renewal filing), or, for a Madrid designation, WIPO published an expiry for the international registration in a later term. False for the first term after registration, for a term computed on the statutory ladder with no renewal of the term before it on record (a renewal of an earlier term does not count), and when `state` is `not_applicable`.
+             * @example true
+             */
+            renewed: boolean;
+        };
         UnsupportedDeadlineRule: {
             /**
              * @description Slug of the declined rule. Same identity as `rule_id` on a computed row: join it to `GET /v1/deadline-rules` for the rule and its sources.
@@ -2655,7 +2684,7 @@ export interface components {
         };
         DeadlineRow: {
             /**
-             * @description Stable identity of this occurrence of the rule, unique within one trademark: `rule_id:cycle` (the statutory cycle, e.g. `us_renewal_s9:5`), or `rule_id:t<term>-<n>` (a cell on a fixed term grid) when the record has no statutory anchor date or the row is anchored on an office-stated expiry; `rule_id:1` for a rule that occurs once. A renewal or a date correction of a few days keeps the key.
+             * @description Stable identity of this occurrence of the rule, unique within one trademark: `rule_id:cycle` (the statutory cycle, e.g. `us_renewal_s9:5`), or `rule_id:t<term>-<n>` (a cell on a fixed term grid) when the record has no statutory anchor date or the row is anchored on an office-stated expiry; `rule_id:1` for a rule that occurs once; `rule_id:<action date>:<action code>` for a `post_registration_oa_response` row (one per office action, e.g. `uspto_post_registration_oa_response:2026-04-19:PRA8`). A renewal or a date correction of a few days keeps the key.
              * @example us_renewal_s9:5
              */
             occurrence_key: string;
@@ -2664,7 +2693,10 @@ export interface components {
              * @example us_renewal_s9
              */
             rule_id: string;
-            /** @example combined_renewal_and_use */
+            /**
+             * @description Deadline type: `renewal`, `declaration_of_use`, `combined_renewal_and_use`, `declaration_of_incontestability`, `restoration`, `international_renewal`, or `post_registration_oa_response` (USPTO: the response to a post-registration office action on a §8, §71 or §8+§9 filing, due six months from the action or at the end of the filing period, whichever is later; 37 CFR 2.163(b), 2.184(b)(1), 7.39(a)). New values may be added.
+             * @example combined_renewal_and_use
+             */
             type: string;
             /**
              * @description Rule jurisdiction (`WO` for the Madrid international renewal).
@@ -2674,7 +2706,7 @@ export interface components {
             /** @example 2025-01-20 */
             trigger_date: string;
             /**
-             * @description Which record date anchored the computation (filing_date, registration_date, grant_date, protection_grant_date, intl_registration_date), or reported_expiry / reported_renewal_due when the ladder is anchored on an office-stated date.
+             * @description Which record date anchored the computation (filing_date, registration_date, grant_date, protection_grant_date, intl_registration_date), reported_expiry / reported_renewal_due when the ladder is anchored on an office-stated date, or post_registration_action on a `post_registration_oa_response` row (the office action's date).
              * @example registration_date
              */
             trigger_field: string;
@@ -2706,6 +2738,11 @@ export interface components {
             is_optional: boolean;
             /** @example cancellation_and_expiration */
             consequence_if_missed: string;
+            /**
+             * @description Present only when the office record adds something the dates do not say. On a `post_registration_oa_response` row: the office action it answers (code and date), and any incomplete-response notice or missing filing history; when the record cannot settle the date, the row is served on the earliest defensible date and the note says to check TSDR. A post-registration action marked "no response required" with no response row to carry it is said on every row of the record while its petition period can run. When the office prosecution history could not be read, every row of the record says so here instead of reading as checked.
+             * @example PRA8 2026-04-19
+             */
+            note?: string;
         };
         DerivedOppositionWindow: {
             /** @enum {boolean} */
@@ -2765,10 +2802,11 @@ export interface components {
              */
             as_of_date: string;
             /**
-             * @description The rulebook's term end (the office-stated expiry when the office publishes one).
+             * @description The end of the term on record, before any weekend or holiday roll. Where the office publishes the expiry it is that date, moved forward only by a renewal on record: one the office recorded, or for a Madrid designation an expiry WIPO published for the international registration in a later term. Where the office publishes none (the USPTO) it is the statutory term end. Once an office-stated term has ended it stays here; `term.state` says whether it can still be renewed or restored, or that no renewal of it is on record. Null when no term applies (a dead mark once it can no longer be saved, a record with no renewal rule, or no schedule).
              * @example 2035-01-20
              */
             expiry_date: string | null;
+            term: components["schemas"]["DerivedTerm"];
             deadlines: {
                 /** @description False when no schedule could be computed; see `reason`. Mirrors POST /v1/deadlines/compute. */
                 supported: boolean;
@@ -2825,6 +2863,21 @@ export interface components {
                 /** @example /v1/trademarks/tm_7d4e1f2a-3b8c-4d0e-9f1a-2b3c4d5e6f70 */
                 href: string;
             } | null;
+            /**
+             * @description WIPO ST.3 code of the office that holds the designation record shown for this territory (the national office when Signa has its record, else WO).
+             * @example US
+             */
+            office_code: string | null;
+            /**
+             * @description That record's own application number at its office (for a US designation, the 79-series serial); null when the office states none.
+             * @example 79415041
+             */
+            application_number: string | null;
+            /**
+             * @description That record's own registration number at its office; null until registered or when the office states none.
+             * @example 7000001
+             */
+            registration_number: string | null;
         };
         DetailCoverageTerritory: components["schemas"]["CoverageTerritory"] & {
             /** @example United States of America */
@@ -3108,7 +3161,7 @@ export interface components {
             }[];
             has_media: boolean;
             /**
-             * @description Media-proxy URL for the primary mark image. Null when the mark has no media.
+             * @description Media-proxy URL for the primary mark image: the office-flagged image, else the first image. Always an image file, never a document, audio or video file. Null when the mark has no image.
              * @example https://api.signa.so/v1/trademarks/tm_abc/media/01234567-89ab-cdef-0123-456789abcdef
              */
             primary_image_url: string | null;
@@ -3150,6 +3203,14 @@ export interface components {
                 /** @example representative */
                 role: string;
                 address: components["schemas"]["Address"];
+                /**
+                 * @description On a Madrid international registration row: the designated territories whose record names this attorney, sorted. Empty when only the international registration itself names the attorney. Absent on other rows.
+                 * @example [
+                 *       "EU",
+                 *       "US"
+                 *     ]
+                 */
+                territory_codes?: string[];
             }[];
             text_variants: {
                 /** @example translation */
@@ -3176,7 +3237,23 @@ export interface components {
                 /** @example image/jpeg */
                 mime_type: string | null;
                 url: string;
+                /** @description Exactly one item is primary when `primary_image_url` is set: the item that URL points at. */
                 is_primary: boolean;
+                /**
+                 * @description Signa's classification of the office's document type for a document item (office_action, certificate, correspondence, filed_form, other), the same value `GET /v1/trademarks/{id}/documents` serves; null for images.
+                 * @example office_action
+                 */
+                document_kind: string | null;
+                /**
+                 * @description The office's date on the document (mailing or issue date), as published; null when none.
+                 * @example 2025-02-03
+                 */
+                official_date: string | null;
+                /**
+                 * @description Page count of a document item, as published by the office; null when none.
+                 * @example 4
+                 */
+                page_count: number | null;
             }[];
             priority_claims: {
                 /** @example paris */
@@ -3386,7 +3463,62 @@ export interface components {
              */
             matched_via_kind: "direct" | "regional_membership";
         };
-        /** @description Shape-identical to a /v1/trademarks summary row, minus relevance_score / match_explanation. */
+        /** @description Why the hit is in the result set. Search responses only; on a metadata-only listing (no q, no positive mark_text operator) tier is null and via and terms are empty. */
+        TrademarkMatch: {
+            /**
+             * @description The strongest similarity tier of the lanes this hit matched: identical, near_identical, similar or related. Tiers are retrieval categories, not measured edit distances. Null for rows matched only by a trademark number in q, and for rows of a request without q.
+             * @example near_identical
+             * @enum {string|null}
+             */
+            tier: "identical" | "near_identical" | "similar" | "related" | null;
+            /**
+             * @description The similarity channels that matched this hit, plus `identifier` when q was read as a trademark number. Empty without q.
+             * @example [
+             *       "fuzzy"
+             *     ]
+             */
+            via: ("identifier" | "identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[];
+            /**
+             * @description With a q list: the q terms that reached this hit, in list order, as the caller spelled them. Otherwise the mark_text operator values this hit satisfied (operator order: is, word, starts_with, ends_with, contains, pattern). Empty when the request has neither.
+             * @example []
+             */
+            terms: string[];
+            /** @description Only with include=match_details. */
+            details?: {
+                /**
+                 * @description Internal retrieval lane names that matched.
+                 * @example [
+                 *       "fuzzy_1",
+                 *       "phonetic_strong"
+                 *     ]
+                 */
+                lanes: string[];
+                /** @description The ranking factors applied to this hit's score. Under an explicit sort, a trademark-number q or a q list the length factor does not apply. */
+                factors: {
+                    /** @example live_status */
+                    factor: string;
+                    /** @example 1.3 */
+                    weight: number;
+                }[];
+                /** @description With a q list: each term that reached this hit, with its own tier and channels. */
+                terms?: {
+                    /** @example onyx */
+                    term: string;
+                    /**
+                     * @example identical
+                     * @enum {string|null}
+                     */
+                    tier: "identical" | "near_identical" | "similar" | "related" | null;
+                    /**
+                     * @example [
+                     *       "lookalike"
+                     *     ]
+                     */
+                    via: ("identifier" | "identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[];
+                }[];
+            };
+        };
+        /** @description Shape-identical to a /v1/trademarks summary row, minus relevance_score. */
         TrademarkSummaryV1: {
             /** @example tm_7d4e1f2a3b8c9d0e */
             id: string;
@@ -3548,7 +3680,7 @@ export interface components {
             }[];
             has_media: boolean;
             /**
-             * @description Media-proxy URL for the primary mark image. Null when the mark has no media.
+             * @description Media-proxy URL for the primary mark image: the office-flagged image, else the first image. Always an image file, never a document, audio or video file. Null when the mark has no image.
              * @example https://api.signa.so/v1/trademarks/tm_abc/media/01234567-89ab-cdef-0123-456789abcdef
              */
             primary_image_url: string | null;
@@ -3563,39 +3695,11 @@ export interface components {
             /** @description Search responses only, when a jurisdictions filter is active under the default protection mode: why this hit satisfied it. */
             territory_matches?: components["schemas"]["TerritoryMatch"][];
             /**
-             * @description Search responses only: relevance (0–100) for the ranked `similar` mode. Null when ranking is bypassed (explicit sort or a deterministic match mode); absent without a text query.
+             * @description Search responses only: how well the hit matches q (0–100), for ordering only, not a likelihood of confusion. Present on every hit when q is present, whatever the sort (under a sort the length factor does not apply). Null for rows matched only by a trademark number, for mark_text-only requests, and on metadata-only listings.
              * @example 87
              */
             relevance_score?: number | null;
-            /** @description Search responses only. Null when ranking is bypassed; absent without a text query. */
-            match_explanation?: {
-                /**
-                 * @example [
-                 *       "exact",
-                 *       "fuzzy",
-                 *       "phonetic"
-                 *     ]
-                 */
-                strategies_matched: string[];
-                /**
-                 * @example [
-                 *       {
-                 *         "factor": "exact_match",
-                 *         "weight": 50
-                 *       },
-                 *       {
-                 *         "factor": "live_status",
-                 *         "weight": 1.3
-                 *       }
-                 *     ]
-                 */
-                boost_factors: {
-                    /** @example live_status */
-                    factor: string;
-                    /** @example 1.3 */
-                    weight: number;
-                }[];
-            } | null;
+            match?: components["schemas"]["TrademarkMatch"];
             /**
              * @description Search responses only: highlight fragments keyed by field name. Null when none were returned.
              * @example {
@@ -3607,13 +3711,6 @@ export interface components {
             highlights?: {
                 [key: string]: string[];
             } | null;
-            /**
-             * @description List searches only (q sent as a list): the terms (as the caller spelled them) this hit is an exact match for.
-             * @example [
-             *       "limber"
-             *     ]
-             */
-            matched_terms?: string[];
         };
         ScreeningHit: {
             /** @enum {string} */
@@ -4407,6 +4504,12 @@ export interface components {
              * @enum {string}
              */
             citations: "available" | "in_progress" | "not_available" | "not_applicable";
+            /**
+             * @description Proceedings (oppositions, cancellations, appeals) availability. `available` = Signa ingests and serves this office's proceedings; `in_progress` = pipeline being built; `not_available` = Signa serves no proceedings for this office. `GET /v1/proceedings` returns proceedings only from `available` offices, and a request scoped by `office_code` to a live office that is not `available` returns 422 `capability_not_available` without running a query or charging credits.
+             * @example available
+             * @enum {string}
+             */
+            proceedings: "available" | "in_progress" | "not_available" | "not_applicable";
         };
         Office: {
             /** @example US */
@@ -4586,15 +4689,18 @@ export interface components {
             jurisdiction_code: string;
             /** @example Section 8 — Declaration of Use */
             name: string;
-            /** @example declaration_of_use */
+            /**
+             * @description Deadline type, the same vocabulary as `type` on computed rows. `post_registration_oa_response` is the USPTO response to a post-registration office action on a §8, §71 or §8+§9 filing.
+             * @example declaration_of_use
+             */
             type: string;
             /**
-             * @description Record date the rule is anchored on. For a `restoration` rule this is the parent renewal rule’s trigger — restoration is anchored off the renewal chain.
+             * @description Record date the rule is anchored on. For a `restoration` rule this is the parent renewal rule’s trigger — restoration is anchored off the renewal chain. For `post_registration_oa_response` it is `post_registration_action`, the date of the office action.
              * @example registration_date
              */
             trigger: string;
             /**
-             * @description Year of the term the rule falls due in. For a `restoration` rule this identifies the RENEWAL CYCLE the restoration attaches to (the cycle it rescues), not a restoration due date — the restoration window itself is given by `window_months` + `starts_from`.
+             * @description Year of the term the rule falls due in. For a `restoration` rule this identifies the RENEWAL CYCLE the restoration attaches to (the cycle it rescues), not a restoration due date — the restoration window itself is given by `window_months` + `starts_from`. 0 for `post_registration_oa_response`, which runs from an office action rather than a term year.
              * @example 6
              */
             due_year: number;
@@ -4620,7 +4726,7 @@ export interface components {
             /** @example 10 */
             renewal_period_years: number;
             /**
-             * @description Length of the restoration window in months. Non-null only on `type: "restoration"` rules.
+             * @description Length of the restoration window in months, or of the response period on a `post_registration_oa_response` rule (six months from the action, or to the end of the pre-grace filing period when that is later: 37 CFR 2.163(b), 2.184(b)(1), 7.39(a)). Null on every other rule.
              * @example null
              */
             window_months: number | null;
@@ -4734,7 +4840,7 @@ export interface components {
              */
             first_renewal_after_cutoff_opens_at_period_start: string | null;
             /**
-             * @description What a month- or year-counted period does when its end day does not exist in the target month (31 August + 6 months; 29 February + 1 year). `last_day` clamps to that month’s last day, the default and the behaviour of every office but Mexico. `first_business_day_of_following_month` runs the period into the next calendar month (MX, Reglamento LPI art. 4o, párrafo segundo). Applied to the due date and the grace expiry, never to `window_opens`. Like `holiday_calendar` and `grace_expiry_rolls_only`, this is resolved PER RULE: art. 4o is the designated office’s own convention, so a rule whose period belongs to the International Bureau reports `last_day` whatever its jurisdiction configures (Madrid Regulations Rule 4(1) and (2) clamp such a period to the month’s last day).
+             * @description What a month- or year-counted period does when its end day does not exist in the target month (31 August + 6 months; 29 February + 1 year). `last_day` clamps to that month’s last day, the default and the behaviour of every office but Mexico. `first_business_day_of_following_month` runs the period into the next calendar month (MX, Reglamento LFPPI art. 7, párrafo segundo). Applied to the due date and the grace expiry, never to `window_opens`. Like `holiday_calendar` and `grace_expiry_rolls_only`, this is resolved PER RULE: art. 7 is the designated office’s own convention, so a rule whose period belongs to the International Bureau reports `last_day` whatever its jurisdiction configures (Madrid Regulations Rule 4(1) and (2) clamp such a period to the month’s last day).
              * @example last_day
              * @enum {string}
              */
@@ -4801,6 +4907,12 @@ export interface components {
              * @enum {string}
              */
             window_starts_on: "date_of_publication" | "day_after" | "first_of_following_month";
+            /**
+             * @description When non-null, the CURRENT era’s window does not OPEN until the first day of the month after the publication month, although its close is still counted per `window_starts_on` (from the publication). Null for every rule but `cn_opposition_madrid`, whose window for a WIPO Gazette date on or after 2027-01-01 is provisional on CNIPA’s draft transitional measures: it opens on the later of two readings (the 1st of the following month) and closes on the earlier (two months from the publication).
+             * @example null
+             * @enum {string|null}
+             */
+            window_opens_on: "first_of_following_month" | null;
             /**
              * @description How the close is counted for the CURRENT era when it opens on the first of the following month with a month-based window. Null for every other rule AND for a rule that only opens that way in its earlier era — see `window_ends_on_before`.
              * @example null
@@ -4841,7 +4953,7 @@ export interface components {
              */
             window_ends_on_before: "corresponding_day_of_start" | "day_before_corresponding_day_of_start" | null;
             /**
-             * @description What a month-counted close date does when the publication's day number does not exist in the target month. `last_day` clamps to that month's last day, which is the default and what every office except Mexico does. `first_business_day_of_following_month` runs the period into the next calendar month and ends it on that month's first business day (Mexico, Reglamento LPI art. 4o, párrafo segundo). Never applies to a day-counted window.
+             * @description What a month-counted close date does when the publication's day number does not exist in the target month. `last_day` clamps to that month's last day, which is the default and what every office except Mexico does. `first_business_day_of_following_month` runs the period into the next calendar month and ends it on that month's first business day (Mexico, Reglamento LFPPI art. 7, párrafo segundo). Never applies to a day-counted window.
              * @example last_day
              * @enum {string}
              */
@@ -5244,28 +5356,73 @@ export interface components {
                 /** @example srch_abc123 */
                 search_id: string;
                 /**
-                 * @description Echo of the text query, or null for filter-only searches.
+                 * @description Echo of the text query, or null for filter-only searches and for a q list.
                  * @example SIGNA
                  */
                 query: string | null;
                 /**
-                 * @description Public search strategies used for the served result set. Empty for deterministic match modes.
+                 * @description The similarity channels q ran on (identical is always included). Empty without q.
                  * @example [
-                 *       "exact",
-                 *       "phonetic",
+                 *       "identical",
                  *       "fuzzy",
-                 *       "prefix"
+                 *       "embedded",
+                 *       "lookalike"
                  *     ]
                  */
-                strategies_used: ("exact" | "phonetic" | "fuzzy" | "prefix")[];
+                similarity_applied: ("identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[];
+                /**
+                 * @description Version of the ranking that ordered this response. Cursors are bound to it: a new version restarts pagination (400 `cursor_invalid`).
+                 * @example v12
+                 */
+                ranking_version: string;
                 /**
-                 * @description How the query matched the mark text. 'similar' runs the ranked ladder; exact/starts_with/ends_with/contains are deterministic (relevance_score is null on every row).
-                 * @example similar
+                 * @description The order applied: `relevance` (q present), `mark_text_fit` (text order for a mark_text-only request), `filing_date` (newest filing first), or the explicit `sort` string.
+                 * @example relevance
+                 */
+                order: string;
+                /**
+                 * @description False only when the search hit its time limit or lost a shard and the request set allow_partial; the page may then be missing matches. Without allow_partial such a search returns 503.
+                 * @example true
+                 */
+                complete: boolean;
+                /**
+                 * @description Why `complete` is false. Omitted when complete.
+                 * @example timeout
                  * @enum {string}
                  */
-                match: "similar" | "exact" | "starts_with" | "ends_with" | "contains";
+                incomplete_reason?: "timeout" | "shard_failure";
+                /** @description Present when q was read as a trademark number: those records are looked up besides the ranked text match and listed first. */
+                identifier?: {
+                    /**
+                     * @description WIPO ST.3 code when q names or implies one office; null for a bare number.
+                     * @example US
+                     */
+                    office: string | null;
+                    /**
+                     * @example number
+                     * @enum {string}
+                     */
+                    kind: "application" | "registration" | "ir" | "signa_id" | "number";
+                    /**
+                     * @description The number in the office's stored form (a tm_ id for signa_id).
+                     * @example 1939139
+                     */
+                    number: string;
+                };
+                /** @description The deprecated parameters this request used, each with its replacement. Omitted when none. */
+                deprecations?: {
+                    /** @example strategies */
+                    param: string;
+                    /** @example similarity */
+                    replacement: string;
+                    /**
+                     * @description Date (UTC) from which the deprecated parameter is rejected.
+                     * @example 2026-12-28
+                     */
+                    sunset: string;
+                }[];
                 /**
-                 * @description International registration presentation actually served. grouped = one row per mark/IR, coverage block present on IR rows; expanded = one row per Madrid designation.
+                 * @description International registration presentation actually served. grouped = one row per mark/IR, coverage block present on IR rows; expanded = one row per Madrid designation. A trademark number in q is served expanded: one row per record it names.
                  * @example grouped
                  * @enum {string}
                  */
@@ -5281,24 +5438,24 @@ export interface components {
                  * @enum {string}
                  */
                 territory_match: "protection" | "direct";
-                /** @description Coded search warnings: per-strategy skip warnings (a REQUESTED strategy produced zero clauses for the query shape — e.g. strategies=[phonetic] on a query too short/high-collision), filter-coverage warnings (an applied filter, e.g. opposition_status or seniority_claims, has partial index coverage), `expanded_fallback` (a grouped request was served one row per record), and `result_window_reached` (the 10,000-row result window, not the data, ends this walk). Omitted when there is nothing to warn about. */
+                /** @description Coded search warnings: per-channel skip warnings (a REQUESTED similarity channel produced zero clauses for the query shape — e.g. similarity=phonetic on a query too short/high-collision), filter-coverage warnings (an applied filter, e.g. opposition_status or seniority_claims, has partial index coverage), `expanded_fallback` (a grouped request was served one row per record), `identifier_lookup` (q is a trademark number, served one row per record it names), and `result_window_reached` (the 10,000-row result window, not the data, ends this walk). Omitted when there is nothing to warn about. */
                 warnings?: {
                     /**
-                     * @description Stable warning code for client handling: `<strategy>_skipped` (a requested strategy produced no clauses), `partial_opposition_coverage` / `partial_seniority_coverage` (filter coverage), `partial_results` (the search hit its time limit or lost a shard; the page may be missing matches), `strategies_reduced` (OpenSearch rejected the full query and it was retried with fewer strategies; see `dropped_strategies`), `expanded_fallback` (a grouped request was served one row per record because the grouped view cannot serve a filter, sort or option; see `affected_filters` / `affected_option`), `result_window_reached` (more than 10,000 rows match and this page is the last one the 10,000-row result window lets a relevance or sorted walk reach), `mixed_script` (a `q` term, or a term of a `q` list, under a deterministic `match` mode mixes Latin with Greek or Cyrillic letters, which that mode compares as written; see `affected_filter`).
+                     * @description Stable warning code for client handling: `<channel>_skipped` (a requested similarity channel produced no clauses for this query; see `channel`), `partial_opposition_coverage` / `partial_seniority_coverage` (filter coverage), `expanded_fallback` (a grouped request was served one row per record because the grouped view cannot serve a filter, sort or option; see `affected_filters` / `affected_option`), `identifier_lookup` (`q` is a trademark number, so the response lists the records it names, one row per record), `result_window_reached` (more than 10,000 rows match and this page is the last one the 10,000-row result window lets a relevance or sorted walk reach), `mixed_script` (a mark_text operator value mixes Latin with Greek or Cyrillic letters, which the operators compare as written; see `affected_filter`).
                      * @example phonetic_skipped
                      */
                     code: string;
                     /**
                      * @description Human-readable explanation of the warning.
-                     * @example phonetic_skipped: the phonetic strategy produced no clauses for this query.
+                     * @example phonetic_skipped: the phonetic similarity channel produced no clauses for this query.
                      */
                     message: string;
                     /**
-                     * @description For strategy-skip warnings, the requested strategy that produced no clauses.
+                     * @description For `<channel>_skipped` warnings, the requested similarity channel that produced no clauses.
                      * @example phonetic
                      * @enum {string}
                      */
-                    strategy?: "exact" | "phonetic" | "fuzzy" | "prefix";
+                    channel?: "identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike";
                     /**
                      * @description Warning severity (filter-coverage warnings).
                      * @example warning
@@ -5317,13 +5474,6 @@ export interface components {
                      *     ]
                      */
                     affected_offices?: string[];
-                    /**
-                     * @description For `strategies_reduced` warnings, the requested strategies the retry dropped.
-                     * @example [
-                     *       "fuzzy"
-                     *     ]
-                     */
-                    dropped_strategies?: ("exact" | "phonetic" | "fuzzy" | "prefix")[];
                     /**
                      * @description For `expanded_fallback` warnings, the filter(s) the grouped view could not serve. Two entries mean the pair could hold on different designations of one mark.
                      * @example [
@@ -5356,6 +5506,33 @@ export interface components {
             aggregation_metadata?: components["schemas"]["AggregationMetadata"];
             request_id: string;
         };
+        /** @description Mark text operators. Values within one operator are OR; operators are AND. Up to 100 values of 200 characters each. */
+        MarkTextFilters: {
+            /** @description Whole-mark equality (case, accents, punctuation, spacing and trademark notices ignored). */
+            is?: string[];
+            /** @description The value appears as a whole word, or consecutive words, of the mark. */
+            word?: string[];
+            /** @description The folded mark begins with the value. */
+            starts_with?: string[];
+            /** @description The folded mark ends with the value. At least 3 characters. */
+            ends_with?: string[];
+            /** @description The value appears anywhere in the folded mark. At least 3 characters. */
+            contains?: string[];
+            /** @description `*` any run, `?` one character, `\` escapes the next character; everything else literal. */
+            pattern?: string[];
+        };
+        /** @description Exclusions: rows matching any value are removed. Never affects ranking. */
+        SearchExclude: {
+            mark_text?: components["schemas"]["MarkTextFilters"];
+            /** @description Exclude marks whose owners are linked to these entities (ent_...). */
+            entity_id?: string[];
+            /** @description Exclude marks linked to any entity in these entities' corporate families (ent_...). */
+            entity_group?: string[];
+            /** @description Exclude marks held by these owners (own_...). */
+            owner_id?: string[];
+            /** @description Exclude these trademarks (tm_...); on the grouped view, the family row containing them. */
+            trademark_ids?: string[];
+        };
         TrademarkEvent: {
             /** @example hst_7d4e1f2a-3b8c-4d0e-9f1a-2b3c4d5e6f70 */
             id: string;
@@ -5949,30 +6126,33 @@ export interface components {
              * @example ent_a1b2c3d4
              */
             entity_id: string | null;
-            /** @description Whether the (possibly entity-inherited) company set includes an active SEC company with a ticker. */
+            /** @description Whether the owner's company links include an active SEC company with a ticker. For an owner linked to an entity, the entity's `publicly_traded`: any active SEC company with a ticker across members, or the entity itself is listed or a subsidiary of a listed company. */
             publicly_traded: boolean;
             /**
-             * @description First SEC ticker across the (possibly inherited) company set. null when none.
+             * @description The owner's own first SEC ticker. When it has none and is linked to an entity, the entity's `ticker`, which can be a ticker inherited from a listed ancestor. null when none.
              * @example AAPL
              */
             ticker: string | null;
             /**
-             * @description First GLEIF LEI across the (possibly inherited) company set. null when none.
+             * @description The owner's own first GLEIF LEI, uppercased. When it has none and is linked to an entity, the entity's `lei`: its own LEI when set, else the first GLEIF LEI across members. null when none.
              * @example HWUPKR0MPOU8FGXBT394
              */
             lei: string | null;
-            /** @description Whether any GLEIF LEI is present across the (possibly inherited) company set. */
+            /** @description Whether the owner's company links include a GLEIF LEI. For an owner linked to an entity, the entity's `has_lei`: its own LEI, or any GLEIF LEI across members. */
             has_lei: boolean;
             /**
-             * @description `entity` when company facts are inherited across entity members; `direct` for an unlinked singleton.
+             * @description `entity` when company facts are inherited across entity members; `direct` when the owner is not linked, or its entity is no longer served (GET /v1/entities/{id} returns 404), and the facts are its own links only.
              * @example entity
              * @enum {string}
              */
             companies_source: "entity" | "direct";
-            /** @example 1024 */
+            /**
+             * @description Distinct marks (mark grain): a Madrid IR and its designations count once, matching the default grouped trademark listings. 0 when stats are not yet computed.
+             * @example 1024
+             */
             trademark_count: number;
             /**
-             * @description Count of ACTIVE trademarks (registered + pending). Always present; 0 when stats are not yet computed. Same mark grain as trademark_count.
+             * @description Distinct marks (mark grain) that are registered or still in prosecution. Always present; 0 when stats are not yet computed.
              * @example 640
              */
             active_count: number;
@@ -5988,7 +6168,7 @@ export interface components {
                 identifier: string;
                 identifier_type: string;
             }[];
-            /** @description Omitted entirely when empty. When the owner is linked to an entity this is the union of all members' company links (served through the entity); the owner's own links are included. */
+            /** @description Omitted entirely when empty. When the owner is linked to an entity this is the union of all members' company links (served through the entity), the owner's own links first. */
             companies?: {
                 /** @example sec */
                 source: string;
@@ -6015,23 +6195,34 @@ export interface components {
                 verified_by?: string | null;
             }[];
             stats: {
+                /** @description Distinct marks (mark grain): a Madrid IR and its designations count once, matching the default grouped trademark listings. 0 when stats are not yet computed. */
                 trademark_count: number;
+                /** @description Office records (record grain) at this status stage. A Madrid IR counts once per designation record, so the status counts can sum to more than trademark_count. Records at a stage outside the five buckets (for example unknown or opposition_period) are counted in none. */
                 registered_count: number;
+                /** @description Office records (record grain) at this status stage. A Madrid IR counts once per designation record, so the status counts can sum to more than trademark_count. Records at a stage outside the five buckets (for example unknown or opposition_period) are counted in none. */
                 pending_count: number;
+                /** @description Office records (record grain) at this status stage. A Madrid IR counts once per designation record, so the status counts can sum to more than trademark_count. Records at a stage outside the five buckets (for example unknown or opposition_period) are counted in none. */
                 expired_count: number;
+                /** @description Office records (record grain) at this status stage. A Madrid IR counts once per designation record, so the status counts can sum to more than trademark_count. Records at a stage outside the five buckets (for example unknown or opposition_period) are counted in none. Includes surrendered and invalidated records. */
                 cancelled_count: number;
+                /** @description Office records (record grain) at this status stage. A Madrid IR counts once per designation record, so the status counts can sum to more than trademark_count. Records at a stage outside the five buckets (for example unknown or opposition_period) are counted in none. Includes withdrawn and refused records. */
                 abandoned_count: number;
                 /**
                  * @deprecated
-                 * @description Deprecated: use grant_rate — same value; registration_rate is a misnomer (it is the share of concluded prosecutions that were ever granted, not the share currently registered).
+                 * @description Deprecated: use grant_rate. Same value; registration_rate is a misnomer (it is the share of concluded prosecutions that were ever granted, not the share currently registered).
                  */
                 registration_rate: number | null;
-                /** @description Share of concluded prosecutions (registered + expired + cancelled) that were ever granted. Same value as the deprecated registration_rate. */
+                /** @description Share of concluded prosecutions (registered + expired + cancelled) that were ever granted, over office records (record grain). Same value as the deprecated registration_rate. */
                 grant_rate: number | null;
+                /** @description Share of concluded prosecutions (record grain) that ended abandoned, withdrawn or refused: abandoned / (registered + expired + cancelled + abandoned). */
                 abandonment_rate: number | null;
+                /** @description Distinct offices among the records. A Madrid IR's designations recorded by WIPO count as one office. */
                 jurisdiction_count: number;
+                /** @description Earliest filing_date over the records (YYYY-MM-DD). */
                 earliest_filing_date: string | null;
+                /** @description Latest filing_date over the records (YYYY-MM-DD). */
                 latest_filing_date: string | null;
+                /** @description When this stats row was last recomputed. The row only changes when a value changes, so an unchanged portfolio keeps its earlier stamp. */
                 computed_at: string | null;
             } | null;
             created_at: string;
@@ -6052,8 +6243,9 @@ export interface components {
              * @example corporation
              */
             legal_form: string | null;
+            /** @description Distinct marks (mark grain): a Madrid IR and its designations count once, matching the default grouped trademark listings. 0 when stats are not yet computed. */
             trademark_count: number;
-            /** @description Count of ACTIVE trademarks (registered + pending). Always present; 0 when stats not yet computed. */
+            /** @description Distinct marks (mark grain) that are registered or still in prosecution. Always present; 0 when stats are not yet computed. */
             active_count: number;
             /**
              * @description The resolved entity this owner is linked into. null when the owner is not linked to an entity.
@@ -6087,28 +6279,73 @@ export interface components {
                 /** @example srch_abc123 */
                 search_id: string;
                 /**
-                 * @description Echo of the text query, or null for filter-only searches.
+                 * @description Echo of the text query, or null for filter-only searches and for a q list.
                  * @example SIGNA
                  */
                 query: string | null;
                 /**
-                 * @description Public search strategies used for the served result set. Empty for deterministic match modes.
+                 * @description The similarity channels q ran on (identical is always included). Empty without q.
                  * @example [
-                 *       "exact",
-                 *       "phonetic",
+                 *       "identical",
                  *       "fuzzy",
-                 *       "prefix"
+                 *       "embedded",
+                 *       "lookalike"
                  *     ]
                  */
-                strategies_used: ("exact" | "phonetic" | "fuzzy" | "prefix")[];
+                similarity_applied: ("identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[];
+                /**
+                 * @description Version of the ranking that ordered this response. Cursors are bound to it: a new version restarts pagination (400 `cursor_invalid`).
+                 * @example v12
+                 */
+                ranking_version: string;
+                /**
+                 * @description The order applied: `relevance` (q present), `mark_text_fit` (text order for a mark_text-only request), `filing_date` (newest filing first), or the explicit `sort` string.
+                 * @example relevance
+                 */
+                order: string;
+                /**
+                 * @description False only when the search hit its time limit or lost a shard and the request set allow_partial; the page may then be missing matches. Without allow_partial such a search returns 503.
+                 * @example true
+                 */
+                complete: boolean;
                 /**
-                 * @description How the query matched the mark text. 'similar' runs the ranked ladder; exact/starts_with/ends_with/contains are deterministic (relevance_score is null on every row).
-                 * @example similar
+                 * @description Why `complete` is false. Omitted when complete.
+                 * @example timeout
                  * @enum {string}
                  */
-                match: "similar" | "exact" | "starts_with" | "ends_with" | "contains";
+                incomplete_reason?: "timeout" | "shard_failure";
+                /** @description Present when q was read as a trademark number: those records are looked up besides the ranked text match and listed first. */
+                identifier?: {
+                    /**
+                     * @description WIPO ST.3 code when q names or implies one office; null for a bare number.
+                     * @example US
+                     */
+                    office: string | null;
+                    /**
+                     * @example number
+                     * @enum {string}
+                     */
+                    kind: "application" | "registration" | "ir" | "signa_id" | "number";
+                    /**
+                     * @description The number in the office's stored form (a tm_ id for signa_id).
+                     * @example 1939139
+                     */
+                    number: string;
+                };
+                /** @description The deprecated parameters this request used, each with its replacement. Omitted when none. */
+                deprecations?: {
+                    /** @example strategies */
+                    param: string;
+                    /** @example similarity */
+                    replacement: string;
+                    /**
+                     * @description Date (UTC) from which the deprecated parameter is rejected.
+                     * @example 2026-12-28
+                     */
+                    sunset: string;
+                }[];
                 /**
-                 * @description International registration presentation actually served. grouped = one row per mark/IR, coverage block present on IR rows; expanded = one row per Madrid designation.
+                 * @description International registration presentation actually served. grouped = one row per mark/IR, coverage block present on IR rows; expanded = one row per Madrid designation. A trademark number in q is served expanded: one row per record it names.
                  * @example grouped
                  * @enum {string}
                  */
@@ -6124,24 +6361,24 @@ export interface components {
                  * @enum {string}
                  */
                 territory_match: "protection" | "direct";
-                /** @description Coded search warnings: per-strategy skip warnings (a REQUESTED strategy produced zero clauses for the query shape — e.g. strategies=[phonetic] on a query too short/high-collision), filter-coverage warnings (an applied filter, e.g. opposition_status or seniority_claims, has partial index coverage), `expanded_fallback` (a grouped request was served one row per record), and `result_window_reached` (the 10,000-row result window, not the data, ends this walk). Omitted when there is nothing to warn about. */
+                /** @description Coded search warnings: per-channel skip warnings (a REQUESTED similarity channel produced zero clauses for the query shape — e.g. similarity=phonetic on a query too short/high-collision), filter-coverage warnings (an applied filter, e.g. opposition_status or seniority_claims, has partial index coverage), `expanded_fallback` (a grouped request was served one row per record), `identifier_lookup` (q is a trademark number, served one row per record it names), and `result_window_reached` (the 10,000-row result window, not the data, ends this walk). Omitted when there is nothing to warn about. */
                 warnings?: {
                     /**
-                     * @description Stable warning code for client handling: `<strategy>_skipped` (a requested strategy produced no clauses), `partial_opposition_coverage` / `partial_seniority_coverage` (filter coverage), `partial_results` (the search hit its time limit or lost a shard; the page may be missing matches), `strategies_reduced` (OpenSearch rejected the full query and it was retried with fewer strategies; see `dropped_strategies`), `expanded_fallback` (a grouped request was served one row per record because the grouped view cannot serve a filter, sort or option; see `affected_filters` / `affected_option`), `result_window_reached` (more than 10,000 rows match and this page is the last one the 10,000-row result window lets a relevance or sorted walk reach), `mixed_script` (a `q` term, or a term of a `q` list, under a deterministic `match` mode mixes Latin with Greek or Cyrillic letters, which that mode compares as written; see `affected_filter`).
+                     * @description Stable warning code for client handling: `<channel>_skipped` (a requested similarity channel produced no clauses for this query; see `channel`), `partial_opposition_coverage` / `partial_seniority_coverage` (filter coverage), `expanded_fallback` (a grouped request was served one row per record because the grouped view cannot serve a filter, sort or option; see `affected_filters` / `affected_option`), `identifier_lookup` (`q` is a trademark number, so the response lists the records it names, one row per record), `result_window_reached` (more than 10,000 rows match and this page is the last one the 10,000-row result window lets a relevance or sorted walk reach), `mixed_script` (a mark_text operator value mixes Latin with Greek or Cyrillic letters, which the operators compare as written; see `affected_filter`).
                      * @example phonetic_skipped
                      */
                     code: string;
                     /**
                      * @description Human-readable explanation of the warning.
-                     * @example phonetic_skipped: the phonetic strategy produced no clauses for this query.
+                     * @example phonetic_skipped: the phonetic similarity channel produced no clauses for this query.
                      */
                     message: string;
                     /**
-                     * @description For strategy-skip warnings, the requested strategy that produced no clauses.
+                     * @description For `<channel>_skipped` warnings, the requested similarity channel that produced no clauses.
                      * @example phonetic
                      * @enum {string}
                      */
-                    strategy?: "exact" | "phonetic" | "fuzzy" | "prefix";
+                    channel?: "identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike";
                     /**
                      * @description Warning severity (filter-coverage warnings).
                      * @example warning
@@ -6160,13 +6397,6 @@ export interface components {
                      *     ]
                      */
                     affected_offices?: string[];
-                    /**
-                     * @description For `strategies_reduced` warnings, the requested strategies the retry dropped.
-                     * @example [
-                     *       "fuzzy"
-                     *     ]
-                     */
-                    dropped_strategies?: ("exact" | "phonetic" | "fuzzy" | "prefix")[];
                     /**
                      * @description For `expanded_fallback` warnings, the filter(s) the grouped view could not serve. Two entries mean the pair could hold on different designations of one mark.
                      * @example [
@@ -6256,12 +6486,17 @@ export interface components {
             /** @example US */
             country_code: string | null;
             /**
-             * @description Total trademarks where this attorney is representative (mark grain). 0 when stats not yet computed.
+             * @description WIPO ST.3 code of the office whose records this attorney row comes from. Attorney records are per office: the same person appears once per office they file at.
+             * @example US
+             */
+            source_office_code: string | null;
+            /**
+             * @description Distinct marks (mark grain): a Madrid IR and its designations count once, matching the default grouped trademark listings. 0 when stats are not yet computed.
              * @example 512
              */
             trademark_count: number;
             /**
-             * @description Count of ACTIVE trademarks (registered + pending). Always present; 0 when stats not yet computed.
+             * @description Distinct marks (mark grain) that are registered or still in prosecution. Always present; 0 when stats are not yet computed.
              * @example 300
              */
             active_count: number;
@@ -6279,24 +6514,36 @@ export interface components {
                 identifier_type: string;
             }[];
             stats: {
+                /** @description Distinct marks (mark grain): a Madrid IR and its designations count once, matching the default grouped trademark listings. 0 when stats are not yet computed. */
                 trademark_count: number;
+                /** @description Office records (record grain) at this status stage. A Madrid IR counts once per designation record, so the status counts can sum to more than trademark_count. Records at a stage outside the five buckets (for example unknown or opposition_period) are counted in none. */
                 registered_count: number;
+                /** @description Office records (record grain) at this status stage. A Madrid IR counts once per designation record, so the status counts can sum to more than trademark_count. Records at a stage outside the five buckets (for example unknown or opposition_period) are counted in none. */
                 pending_count: number;
+                /** @description Office records (record grain) at this status stage. A Madrid IR counts once per designation record, so the status counts can sum to more than trademark_count. Records at a stage outside the five buckets (for example unknown or opposition_period) are counted in none. */
                 expired_count: number;
+                /** @description Office records (record grain) at this status stage. A Madrid IR counts once per designation record, so the status counts can sum to more than trademark_count. Records at a stage outside the five buckets (for example unknown or opposition_period) are counted in none. Includes surrendered and invalidated records. */
                 cancelled_count: number;
+                /** @description Office records (record grain) at this status stage. A Madrid IR counts once per designation record, so the status counts can sum to more than trademark_count. Records at a stage outside the five buckets (for example unknown or opposition_period) are counted in none. Includes withdrawn and refused records. */
                 abandoned_count: number;
                 /**
                  * @deprecated
-                 * @description Deprecated: use grant_rate — same value; registration_rate is a misnomer (it is the share of concluded prosecutions that were ever granted, not the share currently registered).
+                 * @description Deprecated: use grant_rate. Same value; registration_rate is a misnomer (it is the share of concluded prosecutions that were ever granted, not the share currently registered).
                  */
                 registration_rate: number | null;
-                /** @description Share of concluded prosecutions (registered + expired + cancelled) that were ever granted. Same value as the deprecated registration_rate. */
+                /** @description Share of concluded prosecutions (registered + expired + cancelled) that were ever granted, over office records (record grain). Same value as the deprecated registration_rate. */
                 grant_rate: number | null;
+                /** @description Share of concluded prosecutions (record grain) that ended abandoned, withdrawn or refused: abandoned / (registered + expired + cancelled + abandoned). */
                 abandonment_rate: number | null;
+                /** @description Distinct offices among the records. A Madrid IR's designations recorded by WIPO count as one office. */
                 jurisdiction_count: number;
+                /** @description Earliest filing_date over the records (YYYY-MM-DD). */
                 earliest_filing_date: string | null;
+                /** @description Latest filing_date over the records (YYYY-MM-DD). */
                 latest_filing_date: string | null;
+                /** @description Mean days from filing_date to registration_date over records with both dates (record grain). null when no record has both. */
                 avg_prosecution_days: number | null;
+                /** @description When this stats row was last recomputed. The row only changes when a value changes, so an unchanged portfolio keeps its earlier stamp. */
                 computed_at: string | null;
             } | null;
             created_at: string;
@@ -6313,8 +6560,14 @@ export interface components {
             canonical_name: string;
             firm_name: string | null;
             country_code: string | null;
+            /**
+             * @description WIPO ST.3 code of the office whose records this attorney row comes from. Attorney records are per office: the same person appears once per office they file at.
+             * @example US
+             */
+            source_office_code: string | null;
+            /** @description Distinct marks (mark grain): a Madrid IR and its designations count once, matching the default grouped trademark listings. 0 when stats are not yet computed. */
             trademark_count: number;
-            /** @description Count of ACTIVE trademarks (registered + pending). Always present; 0 when stats not yet computed. */
+            /** @description Distinct marks (mark grain) that are registered or still in prosecution. Always present; 0 when stats are not yet computed. */
             active_count: number;
         };
         AttorneyListResponse: {
@@ -6343,28 +6596,73 @@ export interface components {
                 /** @example srch_abc123 */
                 search_id: string;
                 /**
-                 * @description Echo of the text query, or null for filter-only searches.
+                 * @description Echo of the text query, or null for filter-only searches and for a q list.
                  * @example SIGNA
                  */
                 query: string | null;
                 /**
-                 * @description Public search strategies used for the served result set. Empty for deterministic match modes.
+                 * @description The similarity channels q ran on (identical is always included). Empty without q.
                  * @example [
-                 *       "exact",
-                 *       "phonetic",
+                 *       "identical",
                  *       "fuzzy",
-                 *       "prefix"
+                 *       "embedded",
+                 *       "lookalike"
                  *     ]
                  */
-                strategies_used: ("exact" | "phonetic" | "fuzzy" | "prefix")[];
+                similarity_applied: ("identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[];
+                /**
+                 * @description Version of the ranking that ordered this response. Cursors are bound to it: a new version restarts pagination (400 `cursor_invalid`).
+                 * @example v12
+                 */
+                ranking_version: string;
+                /**
+                 * @description The order applied: `relevance` (q present), `mark_text_fit` (text order for a mark_text-only request), `filing_date` (newest filing first), or the explicit `sort` string.
+                 * @example relevance
+                 */
+                order: string;
+                /**
+                 * @description False only when the search hit its time limit or lost a shard and the request set allow_partial; the page may then be missing matches. Without allow_partial such a search returns 503.
+                 * @example true
+                 */
+                complete: boolean;
                 /**
-                 * @description How the query matched the mark text. 'similar' runs the ranked ladder; exact/starts_with/ends_with/contains are deterministic (relevance_score is null on every row).
-                 * @example similar
+                 * @description Why `complete` is false. Omitted when complete.
+                 * @example timeout
                  * @enum {string}
                  */
-                match: "similar" | "exact" | "starts_with" | "ends_with" | "contains";
+                incomplete_reason?: "timeout" | "shard_failure";
+                /** @description Present when q was read as a trademark number: those records are looked up besides the ranked text match and listed first. */
+                identifier?: {
+                    /**
+                     * @description WIPO ST.3 code when q names or implies one office; null for a bare number.
+                     * @example US
+                     */
+                    office: string | null;
+                    /**
+                     * @example number
+                     * @enum {string}
+                     */
+                    kind: "application" | "registration" | "ir" | "signa_id" | "number";
+                    /**
+                     * @description The number in the office's stored form (a tm_ id for signa_id).
+                     * @example 1939139
+                     */
+                    number: string;
+                };
+                /** @description The deprecated parameters this request used, each with its replacement. Omitted when none. */
+                deprecations?: {
+                    /** @example strategies */
+                    param: string;
+                    /** @example similarity */
+                    replacement: string;
+                    /**
+                     * @description Date (UTC) from which the deprecated parameter is rejected.
+                     * @example 2026-12-28
+                     */
+                    sunset: string;
+                }[];
                 /**
-                 * @description International registration presentation actually served. grouped = one row per mark/IR, coverage block present on IR rows; expanded = one row per Madrid designation.
+                 * @description International registration presentation actually served. grouped = one row per mark/IR, coverage block present on IR rows; expanded = one row per Madrid designation. A trademark number in q is served expanded: one row per record it names.
                  * @example grouped
                  * @enum {string}
                  */
@@ -6380,24 +6678,24 @@ export interface components {
                  * @enum {string}
                  */
                 territory_match: "protection" | "direct";
-                /** @description Coded search warnings: per-strategy skip warnings (a REQUESTED strategy produced zero clauses for the query shape — e.g. strategies=[phonetic] on a query too short/high-collision), filter-coverage warnings (an applied filter, e.g. opposition_status or seniority_claims, has partial index coverage), `expanded_fallback` (a grouped request was served one row per record), and `result_window_reached` (the 10,000-row result window, not the data, ends this walk). Omitted when there is nothing to warn about. */
+                /** @description Coded search warnings: per-channel skip warnings (a REQUESTED similarity channel produced zero clauses for the query shape — e.g. similarity=phonetic on a query too short/high-collision), filter-coverage warnings (an applied filter, e.g. opposition_status or seniority_claims, has partial index coverage), `expanded_fallback` (a grouped request was served one row per record), `identifier_lookup` (q is a trademark number, served one row per record it names), and `result_window_reached` (the 10,000-row result window, not the data, ends this walk). Omitted when there is nothing to warn about. */
                 warnings?: {
                     /**
-                     * @description Stable warning code for client handling: `<strategy>_skipped` (a requested strategy produced no clauses), `partial_opposition_coverage` / `partial_seniority_coverage` (filter coverage), `partial_results` (the search hit its time limit or lost a shard; the page may be missing matches), `strategies_reduced` (OpenSearch rejected the full query and it was retried with fewer strategies; see `dropped_strategies`), `expanded_fallback` (a grouped request was served one row per record because the grouped view cannot serve a filter, sort or option; see `affected_filters` / `affected_option`), `result_window_reached` (more than 10,000 rows match and this page is the last one the 10,000-row result window lets a relevance or sorted walk reach), `mixed_script` (a `q` term, or a term of a `q` list, under a deterministic `match` mode mixes Latin with Greek or Cyrillic letters, which that mode compares as written; see `affected_filter`).
+                     * @description Stable warning code for client handling: `<channel>_skipped` (a requested similarity channel produced no clauses for this query; see `channel`), `partial_opposition_coverage` / `partial_seniority_coverage` (filter coverage), `expanded_fallback` (a grouped request was served one row per record because the grouped view cannot serve a filter, sort or option; see `affected_filters` / `affected_option`), `identifier_lookup` (`q` is a trademark number, so the response lists the records it names, one row per record), `result_window_reached` (more than 10,000 rows match and this page is the last one the 10,000-row result window lets a relevance or sorted walk reach), `mixed_script` (a mark_text operator value mixes Latin with Greek or Cyrillic letters, which the operators compare as written; see `affected_filter`).
                      * @example phonetic_skipped
                      */
                     code: string;
                     /**
                      * @description Human-readable explanation of the warning.
-                     * @example phonetic_skipped: the phonetic strategy produced no clauses for this query.
+                     * @example phonetic_skipped: the phonetic similarity channel produced no clauses for this query.
                      */
                     message: string;
                     /**
-                     * @description For strategy-skip warnings, the requested strategy that produced no clauses.
+                     * @description For `<channel>_skipped` warnings, the requested similarity channel that produced no clauses.
                      * @example phonetic
                      * @enum {string}
                      */
-                    strategy?: "exact" | "phonetic" | "fuzzy" | "prefix";
+                    channel?: "identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike";
                     /**
                      * @description Warning severity (filter-coverage warnings).
                      * @example warning
@@ -6416,13 +6714,6 @@ export interface components {
                      *     ]
                      */
                     affected_offices?: string[];
-                    /**
-                     * @description For `strategies_reduced` warnings, the requested strategies the retry dropped.
-                     * @example [
-                     *       "fuzzy"
-                     *     ]
-                     */
-                    dropped_strategies?: ("exact" | "phonetic" | "fuzzy" | "prefix")[];
                     /**
                      * @description For `expanded_fallback` warnings, the filter(s) the grouped view could not serve. Two entries mean the pair could hold on different designations of one mark.
                      * @example [
@@ -6501,9 +6792,10 @@ export interface components {
             canonical_name: string;
             country_code: string | null;
             attorney_count: number;
+            /** @description Distinct marks (mark grain): a Madrid IR and its designations count once, matching the default grouped trademark listings. 0 when stats are not yet computed. */
             trademark_count: number;
             /**
-             * @description Count of ACTIVE trademarks (registered + pending). Always present; 0 when stats not yet computed.
+             * @description Distinct marks (mark grain) that are registered or still in prosecution. Always present; 0 when stats are not yet computed.
              * @example 300
              */
             active_count: number;
@@ -6537,8 +6829,9 @@ export interface components {
             canonical_name: string;
             country_code: string | null;
             attorney_count: number;
+            /** @description Distinct marks (mark grain): a Madrid IR and its designations count once, matching the default grouped trademark listings. 0 when stats are not yet computed. */
             trademark_count: number;
-            /** @description Count of ACTIVE trademarks (registered + pending). Always present; 0 when stats not yet computed. */
+            /** @description Distinct marks (mark grain) that are registered or still in prosecution. Always present; 0 when stats are not yet computed. */
             active_count: number;
             /**
              * @deprecated
@@ -6570,6 +6863,7 @@ export interface components {
             canonical_name: string;
             firm_name: string | null;
             country_code: string | null;
+            /** @description Distinct marks (mark grain): a Madrid IR and its designations count once, matching the default grouped trademark listings. 0 when stats are not yet computed. */
             trademark_count: number;
             /**
              * @deprecated
@@ -6608,28 +6902,73 @@ export interface components {
                 /** @example srch_abc123 */
                 search_id: string;
                 /**
-                 * @description Echo of the text query, or null for filter-only searches.
+                 * @description Echo of the text query, or null for filter-only searches and for a q list.
                  * @example SIGNA
                  */
                 query: string | null;
                 /**
-                 * @description Public search strategies used for the served result set. Empty for deterministic match modes.
+                 * @description The similarity channels q ran on (identical is always included). Empty without q.
                  * @example [
-                 *       "exact",
-                 *       "phonetic",
+                 *       "identical",
                  *       "fuzzy",
-                 *       "prefix"
+                 *       "embedded",
+                 *       "lookalike"
                  *     ]
                  */
-                strategies_used: ("exact" | "phonetic" | "fuzzy" | "prefix")[];
+                similarity_applied: ("identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[];
+                /**
+                 * @description Version of the ranking that ordered this response. Cursors are bound to it: a new version restarts pagination (400 `cursor_invalid`).
+                 * @example v12
+                 */
+                ranking_version: string;
+                /**
+                 * @description The order applied: `relevance` (q present), `mark_text_fit` (text order for a mark_text-only request), `filing_date` (newest filing first), or the explicit `sort` string.
+                 * @example relevance
+                 */
+                order: string;
+                /**
+                 * @description False only when the search hit its time limit or lost a shard and the request set allow_partial; the page may then be missing matches. Without allow_partial such a search returns 503.
+                 * @example true
+                 */
+                complete: boolean;
                 /**
-                 * @description How the query matched the mark text. 'similar' runs the ranked ladder; exact/starts_with/ends_with/contains are deterministic (relevance_score is null on every row).
-                 * @example similar
+                 * @description Why `complete` is false. Omitted when complete.
+                 * @example timeout
                  * @enum {string}
                  */
-                match: "similar" | "exact" | "starts_with" | "ends_with" | "contains";
+                incomplete_reason?: "timeout" | "shard_failure";
+                /** @description Present when q was read as a trademark number: those records are looked up besides the ranked text match and listed first. */
+                identifier?: {
+                    /**
+                     * @description WIPO ST.3 code when q names or implies one office; null for a bare number.
+                     * @example US
+                     */
+                    office: string | null;
+                    /**
+                     * @example number
+                     * @enum {string}
+                     */
+                    kind: "application" | "registration" | "ir" | "signa_id" | "number";
+                    /**
+                     * @description The number in the office's stored form (a tm_ id for signa_id).
+                     * @example 1939139
+                     */
+                    number: string;
+                };
+                /** @description The deprecated parameters this request used, each with its replacement. Omitted when none. */
+                deprecations?: {
+                    /** @example strategies */
+                    param: string;
+                    /** @example similarity */
+                    replacement: string;
+                    /**
+                     * @description Date (UTC) from which the deprecated parameter is rejected.
+                     * @example 2026-12-28
+                     */
+                    sunset: string;
+                }[];
                 /**
-                 * @description International registration presentation actually served. grouped = one row per mark/IR, coverage block present on IR rows; expanded = one row per Madrid designation.
+                 * @description International registration presentation actually served. grouped = one row per mark/IR, coverage block present on IR rows; expanded = one row per Madrid designation. A trademark number in q is served expanded: one row per record it names.
                  * @example grouped
                  * @enum {string}
                  */
@@ -6645,24 +6984,24 @@ export interface components {
                  * @enum {string}
                  */
                 territory_match: "protection" | "direct";
-                /** @description Coded search warnings: per-strategy skip warnings (a REQUESTED strategy produced zero clauses for the query shape — e.g. strategies=[phonetic] on a query too short/high-collision), filter-coverage warnings (an applied filter, e.g. opposition_status or seniority_claims, has partial index coverage), `expanded_fallback` (a grouped request was served one row per record), and `result_window_reached` (the 10,000-row result window, not the data, ends this walk). Omitted when there is nothing to warn about. */
+                /** @description Coded search warnings: per-channel skip warnings (a REQUESTED similarity channel produced zero clauses for the query shape — e.g. similarity=phonetic on a query too short/high-collision), filter-coverage warnings (an applied filter, e.g. opposition_status or seniority_claims, has partial index coverage), `expanded_fallback` (a grouped request was served one row per record), `identifier_lookup` (q is a trademark number, served one row per record it names), and `result_window_reached` (the 10,000-row result window, not the data, ends this walk). Omitted when there is nothing to warn about. */
                 warnings?: {
                     /**
-                     * @description Stable warning code for client handling: `<strategy>_skipped` (a requested strategy produced no clauses), `partial_opposition_coverage` / `partial_seniority_coverage` (filter coverage), `partial_results` (the search hit its time limit or lost a shard; the page may be missing matches), `strategies_reduced` (OpenSearch rejected the full query and it was retried with fewer strategies; see `dropped_strategies`), `expanded_fallback` (a grouped request was served one row per record because the grouped view cannot serve a filter, sort or option; see `affected_filters` / `affected_option`), `result_window_reached` (more than 10,000 rows match and this page is the last one the 10,000-row result window lets a relevance or sorted walk reach), `mixed_script` (a `q` term, or a term of a `q` list, under a deterministic `match` mode mixes Latin with Greek or Cyrillic letters, which that mode compares as written; see `affected_filter`).
+                     * @description Stable warning code for client handling: `<channel>_skipped` (a requested similarity channel produced no clauses for this query; see `channel`), `partial_opposition_coverage` / `partial_seniority_coverage` (filter coverage), `expanded_fallback` (a grouped request was served one row per record because the grouped view cannot serve a filter, sort or option; see `affected_filters` / `affected_option`), `identifier_lookup` (`q` is a trademark number, so the response lists the records it names, one row per record), `result_window_reached` (more than 10,000 rows match and this page is the last one the 10,000-row result window lets a relevance or sorted walk reach), `mixed_script` (a mark_text operator value mixes Latin with Greek or Cyrillic letters, which the operators compare as written; see `affected_filter`).
                      * @example phonetic_skipped
                      */
                     code: string;
                     /**
                      * @description Human-readable explanation of the warning.
-                     * @example phonetic_skipped: the phonetic strategy produced no clauses for this query.
+                     * @example phonetic_skipped: the phonetic similarity channel produced no clauses for this query.
                      */
                     message: string;
                     /**
-                     * @description For strategy-skip warnings, the requested strategy that produced no clauses.
+                     * @description For `<channel>_skipped` warnings, the requested similarity channel that produced no clauses.
                      * @example phonetic
                      * @enum {string}
                      */
-                    strategy?: "exact" | "phonetic" | "fuzzy" | "prefix";
+                    channel?: "identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike";
                     /**
                      * @description Warning severity (filter-coverage warnings).
                      * @example warning
@@ -6681,13 +7020,6 @@ export interface components {
                      *     ]
                      */
                     affected_offices?: string[];
-                    /**
-                     * @description For `strategies_reduced` warnings, the requested strategies the retry dropped.
-                     * @example [
-                     *       "fuzzy"
-                     *     ]
-                     */
-                    dropped_strategies?: ("exact" | "phonetic" | "fuzzy" | "prefix")[];
                     /**
                      * @description For `expanded_fallback` warnings, the filter(s) the grouped view could not serve. Two entries mean the pair could hold on different designations of one mark.
                      * @example [
@@ -6851,11 +7183,11 @@ export interface components {
              */
             tickers: string[];
             /**
-             * @description Survivorship LEI (first aggregated GLEIF LEI, else the entity row LEI).
+             * @description Survivorship LEI, uppercased: the entity's own LEI when set, else the first GLEIF LEI across member companies. null when none.
              * @example HWUPKR0MPOU8FGXBT394
              */
             lei: string | null;
-            /** @description Whether any GLEIF LEI is present across member companies. */
+            /** @description Whether the entity has an LEI: its own, or any GLEIF LEI across member companies. */
             has_lei: boolean;
             /** @description COUNT(DISTINCT trademark) across all member owners (co-owned marks counted once). `null` when the count could not be computed within the read-path timeout for a very large entity (fail-open — the rest of the detail is still served). */
             trademark_count: number | null;
@@ -6924,28 +7256,73 @@ export interface components {
                 /** @example srch_abc123 */
                 search_id: string;
                 /**
-                 * @description Echo of the text query, or null for filter-only searches.
+                 * @description Echo of the text query, or null for filter-only searches and for a q list.
                  * @example SIGNA
                  */
                 query: string | null;
                 /**
-                 * @description Public search strategies used for the served result set. Empty for deterministic match modes.
+                 * @description The similarity channels q ran on (identical is always included). Empty without q.
                  * @example [
-                 *       "exact",
-                 *       "phonetic",
+                 *       "identical",
                  *       "fuzzy",
-                 *       "prefix"
+                 *       "embedded",
+                 *       "lookalike"
                  *     ]
                  */
-                strategies_used: ("exact" | "phonetic" | "fuzzy" | "prefix")[];
+                similarity_applied: ("identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[];
+                /**
+                 * @description Version of the ranking that ordered this response. Cursors are bound to it: a new version restarts pagination (400 `cursor_invalid`).
+                 * @example v12
+                 */
+                ranking_version: string;
+                /**
+                 * @description The order applied: `relevance` (q present), `mark_text_fit` (text order for a mark_text-only request), `filing_date` (newest filing first), or the explicit `sort` string.
+                 * @example relevance
+                 */
+                order: string;
+                /**
+                 * @description False only when the search hit its time limit or lost a shard and the request set allow_partial; the page may then be missing matches. Without allow_partial such a search returns 503.
+                 * @example true
+                 */
+                complete: boolean;
                 /**
-                 * @description How the query matched the mark text. 'similar' runs the ranked ladder; exact/starts_with/ends_with/contains are deterministic (relevance_score is null on every row).
-                 * @example similar
+                 * @description Why `complete` is false. Omitted when complete.
+                 * @example timeout
                  * @enum {string}
                  */
-                match: "similar" | "exact" | "starts_with" | "ends_with" | "contains";
+                incomplete_reason?: "timeout" | "shard_failure";
+                /** @description Present when q was read as a trademark number: those records are looked up besides the ranked text match and listed first. */
+                identifier?: {
+                    /**
+                     * @description WIPO ST.3 code when q names or implies one office; null for a bare number.
+                     * @example US
+                     */
+                    office: string | null;
+                    /**
+                     * @example number
+                     * @enum {string}
+                     */
+                    kind: "application" | "registration" | "ir" | "signa_id" | "number";
+                    /**
+                     * @description The number in the office's stored form (a tm_ id for signa_id).
+                     * @example 1939139
+                     */
+                    number: string;
+                };
+                /** @description The deprecated parameters this request used, each with its replacement. Omitted when none. */
+                deprecations?: {
+                    /** @example strategies */
+                    param: string;
+                    /** @example similarity */
+                    replacement: string;
+                    /**
+                     * @description Date (UTC) from which the deprecated parameter is rejected.
+                     * @example 2026-12-28
+                     */
+                    sunset: string;
+                }[];
                 /**
-                 * @description International registration presentation actually served. grouped = one row per mark/IR, coverage block present on IR rows; expanded = one row per Madrid designation.
+                 * @description International registration presentation actually served. grouped = one row per mark/IR, coverage block present on IR rows; expanded = one row per Madrid designation. A trademark number in q is served expanded: one row per record it names.
                  * @example grouped
                  * @enum {string}
                  */
@@ -6961,24 +7338,24 @@ export interface components {
                  * @enum {string}
                  */
                 territory_match: "protection" | "direct";
-                /** @description Coded search warnings: per-strategy skip warnings (a REQUESTED strategy produced zero clauses for the query shape — e.g. strategies=[phonetic] on a query too short/high-collision), filter-coverage warnings (an applied filter, e.g. opposition_status or seniority_claims, has partial index coverage), `expanded_fallback` (a grouped request was served one row per record), and `result_window_reached` (the 10,000-row result window, not the data, ends this walk). Omitted when there is nothing to warn about. */
+                /** @description Coded search warnings: per-channel skip warnings (a REQUESTED similarity channel produced zero clauses for the query shape — e.g. similarity=phonetic on a query too short/high-collision), filter-coverage warnings (an applied filter, e.g. opposition_status or seniority_claims, has partial index coverage), `expanded_fallback` (a grouped request was served one row per record), `identifier_lookup` (q is a trademark number, served one row per record it names), and `result_window_reached` (the 10,000-row result window, not the data, ends this walk). Omitted when there is nothing to warn about. */
                 warnings?: {
                     /**
-                     * @description Stable warning code for client handling: `<strategy>_skipped` (a requested strategy produced no clauses), `partial_opposition_coverage` / `partial_seniority_coverage` (filter coverage), `partial_results` (the search hit its time limit or lost a shard; the page may be missing matches), `strategies_reduced` (OpenSearch rejected the full query and it was retried with fewer strategies; see `dropped_strategies`), `expanded_fallback` (a grouped request was served one row per record because the grouped view cannot serve a filter, sort or option; see `affected_filters` / `affected_option`), `result_window_reached` (more than 10,000 rows match and this page is the last one the 10,000-row result window lets a relevance or sorted walk reach), `mixed_script` (a `q` term, or a term of a `q` list, under a deterministic `match` mode mixes Latin with Greek or Cyrillic letters, which that mode compares as written; see `affected_filter`).
+                     * @description Stable warning code for client handling: `<channel>_skipped` (a requested similarity channel produced no clauses for this query; see `channel`), `partial_opposition_coverage` / `partial_seniority_coverage` (filter coverage), `expanded_fallback` (a grouped request was served one row per record because the grouped view cannot serve a filter, sort or option; see `affected_filters` / `affected_option`), `identifier_lookup` (`q` is a trademark number, so the response lists the records it names, one row per record), `result_window_reached` (more than 10,000 rows match and this page is the last one the 10,000-row result window lets a relevance or sorted walk reach), `mixed_script` (a mark_text operator value mixes Latin with Greek or Cyrillic letters, which the operators compare as written; see `affected_filter`).
                      * @example phonetic_skipped
                      */
                     code: string;
                     /**
                      * @description Human-readable explanation of the warning.
-                     * @example phonetic_skipped: the phonetic strategy produced no clauses for this query.
+                     * @example phonetic_skipped: the phonetic similarity channel produced no clauses for this query.
                      */
                     message: string;
                     /**
-                     * @description For strategy-skip warnings, the requested strategy that produced no clauses.
+                     * @description For `<channel>_skipped` warnings, the requested similarity channel that produced no clauses.
                      * @example phonetic
                      * @enum {string}
                      */
-                    strategy?: "exact" | "phonetic" | "fuzzy" | "prefix";
+                    channel?: "identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike";
                     /**
                      * @description Warning severity (filter-coverage warnings).
                      * @example warning
@@ -6997,13 +7374,6 @@ export interface components {
                      *     ]
                      */
                     affected_offices?: string[];
-                    /**
-                     * @description For `strategies_reduced` warnings, the requested strategies the retry dropped.
-                     * @example [
-                     *       "fuzzy"
-                     *     ]
-                     */
-                    dropped_strategies?: ("exact" | "phonetic" | "fuzzy" | "prefix")[];
                     /**
                      * @description For `expanded_fallback` warnings, the filter(s) the grouped view could not serve. Two entries mean the pair could hold on different designations of one mark.
                      * @example [
@@ -7071,7 +7441,10 @@ export interface components {
             object: "proceeding";
             /** @example opposition */
             proceeding_type: string;
-            /** @example 91234567 */
+            /**
+             * @description The office's identifier for the proceeding, when it issues one. For CIPO, proceeding_number is the office's per-record sequence identifier (1, 2, …), not a Board docket number.
+             * @example 91234567
+             */
             proceeding_number: string | null;
             /** @example decided_rejected */
             status: string | null;
@@ -7316,9 +7689,13 @@ export interface components {
             base_source: "rule_period" | "stated_deadline" | "rule_absolute_cap" | null;
             /** @description A stated due date the engine REJECTED for exceeding the rule's absolute cap, kept as structured provenance. */
             rejected_stated_due_date: string | null;
+            /** @description The fact that retired this deadline. Null when nothing retired it, and on a closed `post_registration_oa_response` row, whose closing entry (named in `notes`) is not one of the record's facts. */
             closed_by_fact_id: string | null;
-            /** @enum {string|null} */
-            closed_by: "response" | "abandonment" | "sou" | null;
+            /**
+             * @description What retired this deadline. `acceptance` (only on `post_registration_oa_response`): the office accepted the filing the post-registration action examined, so no response is due.
+             * @enum {string|null}
+             */
+            closed_by: "response" | "abandonment" | "sou" | "acceptance" | null;
             /** @description For `outcome: "stated"`: the `stated_deadline` fact that carried the date. */
             stated_by_fact_id: string | null;
             /**
@@ -7342,12 +7719,12 @@ export interface components {
             filing_route: "national" | "regional" | "madrid";
             supported: boolean;
             /**
-             * @description Why no MAINTENANCE schedule was computed; null when `supported` is true. `unsupported_jurisdiction`: no rules are modeled for the jurisdiction. `requires_office_date`: the record does not carry the input the statute needs (Australian direct marks filed before 1996-01-01, Singapore direct marks filed before 1999-01-15, a Madrid designation with no international-registration date, or a Swedish, Icelandic, Norwegian or Finnish direct filing made before the renewal-anchor reform of its office (SE 2019-01-01, IS 2020-09-01, NO 2010-07-01, FI 2019-05-01) with no `registration_date`, since the old-regime term runs from registration, or a record where every rule it owes lacks the date it runs from (for example a registered mark with no registration date where the rules run from registration, or a Swedish mark registered on or after 2019-01-01 with no filing date)) and no `expiry_date` was supplied to anchor on; supply the office-stated `expiry_date` and the schedule is computed from it. The engine declines to guess.
+             * @description Why no MAINTENANCE schedule was computed; null when `supported` is true. `unsupported_jurisdiction`: no rules are modeled for the jurisdiction. `requires_office_date`: the record does not carry the input the statute needs (Australian direct marks filed before 1996-01-01, Singapore direct marks filed before 1999-01-15, a Madrid designation with no international-registration date, or a Swedish, Icelandic, Norwegian or Finnish direct filing made before the renewal-anchor reform of its office (SE 2019-01-01, IS 2020-09-01, NO 2010-07-01, FI 2019-05-01) with no `registration_date`, since the old-regime term runs from registration, or a record where every rule it owes lacks the date it runs from (for example a registered or expired mark with no registration date where the rules run from registration, or a Swedish mark registered on or after 2019-01-01 with no filing date; a cancelled mark owes only a renewal that opens a modelled restoration window, as in Japan, so elsewhere it is supported with no deadlines, unless `include_missed` asks for its missed rows too, which it then owes)) and no `expiry_date` was supplied to anchor on; supply the office-stated `expiry_date` and the schedule is computed from it. The engine declines to guess. In a jurisdiction with modeled rules, never `requires_office_date` for a mark whose status ends every obligation (abandoned, withdrawn, surrendered, invalidated, or refused other than a WIPO international registration record, which keeps its renewal): it is supported with no deadlines.
              * @enum {string|null}
              */
             reason: "unsupported_jurisdiction" | "requires_office_date" | null;
             deadlines: components["schemas"]["ComputedDeadline"][];
-            /** @description Rules that apply to this mark but were declined because it lacks the date the statute anchors them on. `deadlines` has no row for them, so without this list the obligation would be silently absent. Always present: `[]` when nothing was declined, and `[]` when `supported` is false (`reason` already covers every rule). A rule is declined when the date it runs from is owed but absent: a filing date, an international registration date, the Philippine statement of grant (`protection_grant_date`, for the fifth-year declaration of use of a Madrid designation), or, once the mark is registered, its registration or grant date. A registration-anchored rule on an application not yet registered is not declined: nothing is due yet. Supply the missing field to get the row. */
+            /** @description Rules that apply to this mark but were declined because it lacks the date the statute anchors them on. `deadlines` has no row for them, so without this list the obligation would be silently absent. Always present: `[]` when nothing was declined, and `[]` when `supported` is false (`reason` already covers every rule). A rule is declined when the date it runs from is owed but absent: a filing date, an international registration date, the Philippine statement of grant (`protection_grant_date`, for the fifth-year declaration of use of a Madrid designation), or, once the mark is registered (an expired or cancelled mark was), its registration or grant date. The Mexican third-year declaration covers grants from 10 August 2018 only, so a national mark registered before then is not asked for its grant date; a Madrid designation is, since its statement of grant can come years after its international registration. A registration-anchored rule on an application not yet registered is not declined: nothing is due yet. An expired mark names every rule whose miss costs something (its status serves a rule while the window of that rule is open), except, without `include_missed`, a one-off rule of a national mark (a declaration due once, such as US Section 8, the Philippine third- and fifth-year declarations or the Mexican third-year declaration): its window closed before the term ended, so the date would compute nothing to act on; a Madrid designation granted late in the term of its international registration still names it. A cancelled mark names only a renewal that opens a modelled restoration window: its status serves nothing else. With `include_missed`, both name every rule they owe that would return a row, missed or current, as of the computation date for some date the mark could carry, since its missed row would be returned too: a mark cancelled three years after filing is not asked for a registration date, because no Section 8 or 9 window can have closed yet. Supply the missing field and the rule is computed; whether a row is returned then depends on its window, `horizon_years` and `include_missed`, and for an expired mark on that window being open, as for any computed rule. */
             unsupported_rules: components["schemas"]["UnsupportedDeadlineRule"][];
             /**
              * @description Statutory sources of the jurisdiction configuration this computation used. Provenance is per jurisdiction configuration, not per rule: every rule in a jurisdiction shares this one source list, so it is carried once per item rather than on each row. For per-rule detail, join a row's `rule_id` to `GET /v1/deadline-rules`. Empty only when no configuration exists for the jurisdiction.
@@ -7755,7 +8132,7 @@ export interface components {
              */
             grant_date?: string | null;
             /**
-             * @description Office-stated end of the current term. When provided, renewal deadlines anchor on it (trigger_field "reported_expiry") unless the statutory ladder from the trigger date already passes through it. An office-stated renewal-due date (renewal_due_date_basis "reported") anchors the same way when no expiry is stored (trigger_field "reported_renewal_due").
+             * @description Office-stated end of the current term. When provided, renewal deadlines anchor on it (trigger_field "reported_expiry") unless the statutory ladder from the trigger date already passes through it. An office-stated renewal-due date (renewal_due_date_basis "reported") anchors the same way when no expiry is stored (trigger_field "reported_renewal_due"). When it (or the renewal-due date anchoring in its place) has passed, together with its grace period and any restoration window, and no supplied `last_renewal_date` renewed that cycle, the term ended there and no row of a later cycle (renewal, declaration or restoration) is returned.
              * @example null
              */
             expiry_date?: string | null;
@@ -7851,7 +8228,7 @@ export interface components {
              * @enum {string|null}
              */
             reason: "unsupported_jurisdiction" | "requires_office_date" | null;
-            /** @description Rules declined for want of their statutory anchor, as on POST /v1/deadlines/compute. `[]` when `supported` is false. */
+            /** @description Rules declined for want of their statutory anchor, as on POST /v1/deadlines/compute: without `include_missed`, or with it when the list is filtered to `urgency=missed` (the only filter that serves missed rows). `[]` when `supported` is false. */
             unsupported_rules: components["schemas"]["UnsupportedDeadlineRule"][];
         };
         DeadlineListResponse: {
@@ -7864,7 +8241,7 @@ export interface components {
                 total_count?: number;
                 total_count_approximate?: boolean;
             };
-            /** @description Marks in the requested scope whose deadlines could not be computed (they have no rows) or were computed only in part (some rules declined), sorted by `trademark_id`. A mark whose status ends every obligation (`abandoned`, `withdrawn`, `surrendered`, `invalidated`, or `refused` other than a WIPO international registration) is never listed: it is owed no deadlines in any jurisdiction. Covers the whole portfolio or trademark, not just this page, and ignores the `type`, `urgency` and `due_before` filters. Reported on the first page (a request without `cursor`); `null` on every continuation page, because the cursor pins the computation date and the first page already answered for the whole chain. `[]` on a first page means every mark in scope that is owed deadlines was fully computed. */
+            /** @description Marks in the requested scope whose deadlines could not be computed (they have no rows) or were computed only in part (some rules declined), sorted by `trademark_id`. A mark whose status ends every obligation (`abandoned`, `withdrawn`, `surrendered`, `invalidated`, or `refused` other than a WIPO international registration) is never listed: it is owed no deadlines in any jurisdiction. Covers the whole portfolio or trademark, not just this page, and ignores the `type` and `due_before` filters and every `urgency` value but `missed`, which also names the rules declined for missed rows. Reported on the first page (a request without `cursor`); `null` on every continuation page, because the cursor pins the computation date and the first page already answered for the whole chain. `[]` on a first page means every mark in scope that is owed deadlines was fully computed. */
             unsupported_marks: components["schemas"]["DeadlineUnsupportedMark"][] | null;
             request_id: string;
         };
@@ -8095,7 +8472,7 @@ export interface components {
             common_extension: components["schemas"]["OppositionCommonExtension"];
             source: components["schemas"]["OppositionWindowSource"];
             /**
-             * @description Why the window is unsupported or degraded, as a snake_case code; null on every normal window. With `supported: false`: `unsupported_office` (no rule reaches this office, route and publication date) or `window_not_computable` (a rule resolved but no window could be produced). With `supported: true`, a degraded window: `publication_date_kind_mismatch`, meaning the `publication_date_kind` you sent is not the publication the matched Madrid rule runs from, including the explicit `unknown`. A plain missing `publication_date` stays reason-less: `status: "unknown"` with a null `publication_date` already says that. Treat the vocabulary as open — new codes may be added, so branch on the codes you know and fall through on the rest.
+             * @description Why the window is unsupported or degraded, as a snake_case code; null on every normal window. With `supported: false`: `unsupported_office` (no rule exists for this office and route), `before_commencement` (a rule exists, but the publication date, or a sent `filing_date`, falls before the date it applies from; `rule_id` names it and `effective_from` the boundary) or `window_not_computable` (a rule resolved but no window could be produced). With `supported: true`, a degraded window: `publication_date_kind_mismatch`, meaning the `publication_date_kind` you sent is not the publication the matched Madrid rule runs from, including the explicit `unknown`. A plain missing `publication_date` stays reason-less: `status: "unknown"` with a null `publication_date` already says that. Treat the vocabulary as open — new codes may be added, so branch on the codes you know and fall through on the rest.
              * @example null
              */
             reason: string | null;
@@ -8130,7 +8507,7 @@ export interface components {
              */
             publication_date?: string;
             /**
-             * @description Application filing calendar date. Read only by rules whose era pivot is keyed on the filing date (TR: SMK geçici m. 1/1 gives applications filed before 2017-01-10 the former 3-month window even when published later). Omit it and such a rule falls back to the publication date, which yields the shorter modern window; every other rule ignores it.
+             * @description Application filing calendar date. Read only by rules whose era pivot is keyed on the filing date (TR: SMK geçici m. 1/1 gives applications filed before 2017-01-10 the former 3-month window even when published later). Omit it and such a rule falls back to the publication date, which yields the shorter modern window. Also read by a rule that excludes marks already filed when its opposition procedure commenced (CH: filed before 1993-04-01; PL: filed before 2016-04-15), which then has no window; omit it and only the publication date is tested against the commencement. Every other rule ignores it.
              * @example 2026-01-15
              */
             filing_date?: string;
@@ -8186,7 +8563,7 @@ export interface components {
             filing_route: "national" | "regional" | "madrid";
             supported: boolean;
             /**
-             * @description Why no maintenance schedule was computed; null when `supported` is true. Same vocabulary as POST /v1/deadlines/compute.
+             * @description Why no maintenance schedule was computed; null when `supported` is true. Same vocabulary and verdict as POST /v1/deadlines/compute with `include_missed: true`: reconcile reads missed cycles too.
              * @enum {string|null}
              */
             reason: "unsupported_jurisdiction" | "requires_office_date" | null;
@@ -8204,6 +8581,8 @@ export interface components {
             computed_at: string;
             /** @example 10 */
             horizon_years: number;
+            /** @description Rules that apply to the record but were declined because it lacks the date the statute anchors them on, as on POST /v1/deadlines/compute with `include_missed: true` (an expired or cancelled record also names the rules whose missed cycles it cannot date), so a docketed deadline of such a rule has no computed value. `[]` when none, and `[]` when `supported` is false. */
+            unsupported_rules: components["schemas"]["UnsupportedDeadlineRule"][];
         };
         ReconcileComputedProvenance: {
             /** @example us_renewal_s9 */
@@ -9140,11 +9519,16 @@ export interface components {
                     /** @description Present and `true` when the change diff was bounded (entries dropped past the max count, or an over-long from/to value replaced with a sentinel, or a byte-budget cap hit). Absent when the diff is complete. */
                     diff_truncated?: boolean;
                 };
-                /** @description Match metadata (why/how the mark matched the watch). Null for pure-filter / pre-v2 alerts that carry no match scoring. */
+                /** @description Match metadata (why/how the mark matched the watch). Null for pure-filter / pre-v2 alerts that carry no match scoring. `score` is the engine score for the watch query, not the 0-100 search `relevance_score`. */
                 match: {
                     reason: string | null;
                     score: number | null;
                     score_basis: string | null;
+                    /**
+                     * @description Similarity tier of the matched mark, the same label a search hit carries as `match.tier` (identical, near_identical, similar, related). A retrieval category, not a measured edit distance. Null for filter-only watches, marks found only by their number, and alerts emitted before the field existed.
+                     * @enum {string|null}
+                     */
+                    tier: "identical" | "near_identical" | "similar" | "related" | null;
                 } | null;
                 trademark: components["schemas"]["AlertTrademark"];
                 deadline: {
@@ -9219,11 +9603,16 @@ export interface components {
                 /** @description Present and `true` when the change diff was bounded (entries dropped past the max count, or an over-long from/to value replaced with a sentinel, or a byte-budget cap hit). Absent when the diff is complete. */
                 diff_truncated?: boolean;
             };
-            /** @description Match metadata (why/how the mark matched the watch). Null for pure-filter / pre-v2 alerts that carry no match scoring. */
+            /** @description Match metadata (why/how the mark matched the watch). Null for pure-filter / pre-v2 alerts that carry no match scoring. `score` is the engine score for the watch query, not the 0-100 search `relevance_score`. */
             match: {
                 reason: string | null;
                 score: number | null;
                 score_basis: string | null;
+                /**
+                 * @description Similarity tier of the matched mark, the same label a search hit carries as `match.tier` (identical, near_identical, similar, related). A retrieval category, not a measured edit distance. Null for filter-only watches, marks found only by their number, and alerts emitted before the field existed.
+                 * @enum {string|null}
+                 */
+                tier: "identical" | "near_identical" | "similar" | "related" | null;
             } | null;
             trademark: components["schemas"]["AlertTrademark"];
             deadline: {
@@ -9268,6 +9657,17 @@ export interface components {
             };
             request_id: string;
         };
+        WatchDeprecation: {
+            /** @example query.strategies */
+            param: string;
+            /** @example query.similarity */
+            replacement: string;
+            /**
+             * @description Date the deprecated key stops being accepted (YYYY-MM-DD).
+             * @example 2026-12-28
+             */
+            sunset: string;
+        };
         Watch: {
             /** @example wat_01HK... */
             id: string;
@@ -9334,6 +9734,8 @@ export interface components {
             };
             created_at: string;
             updated_at: string;
+            /** @description Present on create, update and bulk responses when the written query used a deprecated key: `strategies` (replaced by `similarity`) or `min_match_tier` (replaced by `min_tier`). The watch is kept as a legacy watch with its original matching until it is re-saved without them. Each entry names the key, its replacement and the date the old key stops being accepted. */
+            deprecations?: components["schemas"]["WatchDeprecation"][];
             request_id: string;
         };
         WatchList: {
@@ -9405,6 +9807,8 @@ export interface components {
                 };
                 created_at: string;
                 updated_at: string;
+                /** @description Present on create, update and bulk responses when the written query used a deprecated key: `strategies` (replaced by `similarity`) or `min_match_tier` (replaced by `min_tier`). The watch is kept as a legacy watch with its original matching until it is re-saved without them. Each entry names the key, its replacement and the date the old key stops being accepted. */
+                deprecations?: components["schemas"]["WatchDeprecation"][];
             }[];
             has_more: boolean;
             pagination: {
@@ -9427,6 +9831,13 @@ export interface components {
             score_threshold: number | null;
             /** @enum {string|null} */
             min_match_tier: "exact" | "normalized" | "fuzzy" | "phonetic" | null;
+            /** @description The similarity channels the watch query runs. Null without q, and for a legacy watch (stored with the deprecated keys, or before v3 and not re-saved since). */
+            similarity_applied: ("identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[] | null;
+            /**
+             * @description The weakest similarity tier that alerts. Null for a legacy watch (stored with the deprecated keys, or before v3 and not re-saved since), which reports min_match_tier.
+             * @enum {string|null}
+             */
+            min_tier: "identical" | "near_identical" | "similar" | "related" | null;
             alert_fired: boolean;
             reason: string;
             /** @enum {string|null} */
@@ -9818,9 +10229,17 @@ export interface components {
              * @example 2026-08-14
              */
             source_date?: string | null;
-            /** @description Portfolios this mark belonged to when the event was recorded, with the external_ref you set on the membership. Frozen at record time, so later membership or reference edits never rewrite an event you already received; null external_ref means unknown or unset. Empty when the mark was in no portfolio. Absent on alert.created. */
-            portfolios?: {
-                /** @example ptf_9aB2xY */
+            /** @description trademark.corrected only: why this status change is a correction of a status Signa published earlier. The rest of the body is the trademark.status_changed shape. */
+            correction?: {
+                /**
+                 * @description status: Signa published a wrong status and this event reverses it. late_office_record: office records reached Signa late and show the mark lapsing or a dead mark returning.
+                 * @enum {string}
+                 */
+                kind: "status" | "late_office_record";
+            };
+            /** @description Portfolios this mark belonged to when the event was recorded, with the external_ref you set on the membership. Frozen at record time, so later membership or reference edits never rewrite an event you already received; null external_ref means unknown or unset. Empty when the mark was in no portfolio. Absent on alert.created. */
+            portfolios?: {
+                /** @example ptf_9aB2xY */
                 id: string;
                 /** @example MATTER-4471 */
                 external_ref: string | null;
@@ -9831,7 +10250,7 @@ export interface components {
             created_at: string;
             request_id: string;
         };
-        /** @description The organization's subscription as Signa mirrors it (status, scheduled cancellation, open dunning record of the live subscription). Present only when the API key holds billing:read (or admin); absent otherwise. */
+        /** @description The organization's subscription as Signa mirrors it (status, scheduled cancellation, open dunning record of the live subscription, plan change scheduled for the period end). Present only when the API key holds billing:read (or admin); absent otherwise. */
         SubscriptionSummary: {
             /**
              * @description The organization's Stripe subscription status as mirrored (`active`, `trialing`, `past_due`, `unpaid`, `paused`, `canceled`, ...). Null when the organization has no subscription.
@@ -9849,6 +10268,25 @@ export interface components {
                 /** @description Stripe-hosted page to pay the open invoice or update the payment method. */
                 invoice_url: string | null;
             } | null;
+            /** @description A downgrade or a switch to monthly billing made through POST /v1/organization/billing/plan-change that waits for the end of the current period; null when none is pending. Requesting the current plan and interval from that endpoint undoes it. Null once it takes effect, and once the subscription is cancelled or the change is released in Stripe. */
+            scheduled_change?: {
+                /**
+                 * @description The plan the subscription changes to (canonical name).
+                 * @example starter
+                 */
+                plan: string;
+                /**
+                 * @description The billing interval it changes to.
+                 * @example monthly
+                 * @enum {string}
+                 */
+                interval: "monthly" | "annual";
+                /**
+                 * @description When the change takes effect: the end of the current billing period (ISO 8601).
+                 * @example 2026-11-02T00:00:00.000Z
+                 */
+                effective_at: string;
+            } | null;
         };
         Identity: {
             /** @enum {string} */
@@ -10332,7 +10770,7 @@ export interface components {
         };
         StripePlanChangeResponse: {
             /**
-             * @description applied: Stripe applied the change (the proration invoice was paid, or nothing was owed); the plan and credits follow through the webhooks within seconds. pending_payment: the proration payment failed or needs authentication, so nothing changed yet — the customer pays hosted_invoice_url; paying applies the change, and after about 23 hours unpaid Stripe voids the invoice and drops it. scheduled: a downgrade or a shorter interval takes effect at the current period end (effective_at); nothing is charged now.
+             * @description applied: Stripe applied the change (the proration invoice was paid, or nothing was owed); the plan and credits follow through the webhooks within seconds. Also the answer when the request undid a change scheduled here (the current plan and interval were requested): the schedule is released and nothing is charged. pending_payment: the proration payment failed or needs authentication, so nothing changed yet — the customer pays hosted_invoice_url; paying applies the change, and after about 23 hours unpaid Stripe voids the invoice and drops it. scheduled: a downgrade or a shorter interval takes effect at the current period end (effective_at); nothing is charged now.
              * @enum {string}
              */
             outcome: "applied" | "pending_payment" | "scheduled";
@@ -11944,9 +12382,24 @@ export interface operations {
             query?: {
                 q?: string;
                 sort?: string;
-                strategies?: ("exact" | "phonetic" | "fuzzy" | "prefix")[] | null;
-                match?: "similar" | "exact" | "starts_with" | "ends_with" | "contains";
-                mark_text_not_contains?: string;
+                similarity?: ("identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[] | null;
+                mark_text_is?: string[] | null;
+                mark_text_word?: string[] | null;
+                mark_text_starts_with?: string[] | null;
+                mark_text_ends_with?: string[] | null;
+                mark_text_contains?: string[] | null;
+                mark_text_pattern?: string[] | null;
+                mark_text_not_is?: string[] | null;
+                mark_text_not_word?: string[] | null;
+                mark_text_not_starts_with?: string[] | null;
+                mark_text_not_ends_with?: string[] | null;
+                mark_text_not_contains?: string[] | null;
+                mark_text_not_pattern?: string[] | null;
+                entity_id_not?: string[] | null;
+                entity_group_not?: string[] | null;
+                owner_id_not?: string[] | null;
+                trademark_ids_not?: string[] | null;
+                allow_partial?: boolean | null;
                 status_primary?: ("pending" | "active" | "inactive" | "unknown" | "mixed")[] | null;
                 status_stage?: ("filed" | "examining" | "pending_publication" | "published" | "opposition_period" | "pending_opposition" | "pending_cancellation" | "pending_issuance" | "registered" | "allowed" | "abandoned" | "withdrawn" | "surrendered" | "refused" | "cancelled" | "invalidated" | "expired" | "unknown" | "mixed")[] | null;
                 status_reason?: ("refused" | "withdrawn" | "abandoned" | "cancelled" | "invalidated" | "expired" | "surrendered" | "revoked" | "other")[] | null;
@@ -12032,7 +12485,7 @@ export interface operations {
                 is_retracted?: boolean | null;
                 is_series_mark?: boolean | null;
                 international_registrations?: "grouped" | "expanded";
-                include?: "full_goods_services"[] | null;
+                include?: ("full_goods_services" | "match_details")[] | null;
                 fields?: string[] | null;
                 owner_publicly_traded?: boolean | null;
                 owner_has_lei?: boolean | null;
@@ -12111,23 +12564,15 @@ export interface operations {
             content: {
                 "application/json": {
                     /**
-                     * @description Search query: one term as a string, or a list of exact terms. A list returns every mark that is an exact match under match=exact rules (case, accents, punctuation and spacing) for ANY of its terms, and each hit carries matched_terms[]. A list takes 1-100 terms of up to 200 characters; terms that differ only in case or accents are sent once under the first spelling, and matched_terms lists the kept spellings a hit matches. A list runs match=exact (the default for a list; any other match, or strategies, is a 400). One page costs the same as any search page regardless of term count. A string needs 2 characters for match=similar and 1 for the deterministic match modes. Optional for filtered listing.
+                     * @description Search text, ranked through the similarity channels: 1-500 characters, at least 2 after case and accent folding (one CJK character is enough). Always literal; filter on the mark text with the mark_text operators. A trademark number in q (1939139, US 5123456, tm_...) is also looked up and its records lead the page. Optional for a filtered listing. A list of 1-100 terms (each up to 200 characters, e.g. spelling variants) runs every term through the same similarity channels in one search: a hit ranks by its best term and match.terms names the terms that reached it. A list over 10 terms needs similarity limited to identical and lookalike; with fuzzy, embedded or phonetic a list takes 10 terms and 30 words in total. A list is never read as a trademark number.
                      * @example SIGNA
                      */
-                    query?: string | string[];
-                    /** @description Alias for `query` (parity with GET /v1/trademarks). Pass one or the other, not both. */
                     q?: string | string[];
-                    /** @description Sort field(s), comma-separated, - prefix for desc. Valid: filing_date, registration_date, expiry_date, renewal_due_date, updated_at, publication_date, termination_date, office_code, jurisdiction_code, mark_text, owner_name. Max 3. Default: -filing_date when no query. Note: sort=office_code orders by the stored office identifier, which can differ from the alphabetical order of the ST.3 codes shown in office_code. */
+                    /** @description Similarity channels for q: identical, fuzzy, embedded, phonetic, lookalike. Default identical, fuzzy, embedded, lookalike; identical is always on. Requires q. */
+                    similarity?: ("identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[];
+                    exclude?: components["schemas"]["SearchExclude"];
+                    /** @description Sort field(s), comma-separated, - prefix for desc. Default: relevance with q, mark text order with a mark_text filter and no q, otherwise -filing_date. relevance_score stays on every hit under any sort when q is present. sort=office_code orders by the ST.3 code shown in office_code. Valid: filing_date, registration_date, expiry_date, renewal_due_date, updated_at, publication_date, termination_date, office_code, jurisdiction_code, mark_text, owner_name. Max 3. */
                     sort?: string;
-                    /** @description Search strategies (match=similar only). Defaults to exact + fuzzy for text queries. Only the strategies passed run: exact = whole-mark match (plus serial/registration numbers); synonym and phrase matching are part of fuzzy. */
-                    strategies?: ("exact" | "phonetic" | "fuzzy" | "prefix")[];
-                    /**
-                     * @description How the query matches the mark text: similar (default, ranked) | exact | starts_with | ends_with | contains. Deterministic modes require a query and disallow strategies.
-                     * @enum {string}
-                     */
-                    match?: "similar" | "exact" | "starts_with" | "ends_with" | "contains";
-                    /** @description Exclude marks whose text contains this substring (case/accent-insensitive). Composable with any match mode. */
-                    mark_text_not_contains?: string;
                     /**
                      * @description How filters.jurisdictions matches: protection (default — includes regional rights whose membership covers the requested territory, e.g. a EUTM for jurisdictions=[FR]) or direct (literal territory legs only).
                      * @enum {string}
@@ -12258,6 +12703,7 @@ export interface operations {
                         /** @description Filter by exact LEI (uppercased server-side). */
                         owner_lei?: string;
                         trademark_ids?: string[];
+                        mark_text?: components["schemas"]["MarkTextFilters"];
                     };
                     options?: {
                         aggregations?: ("status_stage" | "office_code" | "jurisdiction_code" | "nice_classes" | "filing_year" | "mark_feature_type" | "mark_legal_category" | "filing_route" | "right_kind" | "scope_kind" | "firm_id" | "attorney_id" | "owner_country" | "owner_id" | "entity_id" | "owner_count" | "entity_count")[];
@@ -12268,26 +12714,28 @@ export interface operations {
                         aggregation_mode?: "filtered" | "exclude_own_filter";
                         aggregations_only?: boolean;
                         include_total?: boolean;
-                        /** @description If true, includes highlight snippets under the default similar match mode. In deterministic match modes, highlights is inert. */
+                        /** @description If true, includes highlight snippets for a ranked q. */
                         highlights?: boolean;
                         include_timing?: boolean;
+                        /** @description Return 200 with search_meta.complete=false when the engine times out or a shard fails, instead of 503. Default false. */
+                        allow_partial?: boolean;
                     };
                     /** @default 20 */
                     limit?: number;
                     cursor?: string;
                     /**
-                     * @description International registration presentation. Default grouped → one row per mark/IR, with coverage on IR rows. Use expanded for one row per Madrid designation.
+                     * @description International registration presentation. Default grouped → one row per mark/IR, with coverage on IR rows; a trademark number in q returns one row per record it names. Use expanded for one row per Madrid designation.
                      * @example grouped
                      * @enum {string}
                      */
                     international_registrations?: "grouped" | "expanded";
                     /**
-                     * @description Optional row projections. `full_goods_services` returns full classifications[].goods_services_text; default rows truncate long G&S text to about 280 characters.
+                     * @description Optional row projections. `full_goods_services` returns full classifications[].goods_services_text; default rows truncate long G&S text to about 280 characters. `match_details` adds match.details (the matched lanes and the ranking factors applied) to each hit.
                      * @example [
                      *       "full_goods_services"
                      *     ]
                      */
-                    include?: "full_goods_services"[];
+                    include?: ("full_goods_services" | "match_details")[];
                     /**
                      * @description Sparse top-level field projection. id and object are always retained.
                      * @example [
@@ -13308,7 +13756,24 @@ export interface operations {
         parameters: {
             query?: {
                 q?: string;
-                strategies?: ("exact" | "phonetic" | "fuzzy" | "prefix")[] | null;
+                similarity?: ("identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[] | null;
+                mark_text_is?: string[] | null;
+                mark_text_word?: string[] | null;
+                mark_text_starts_with?: string[] | null;
+                mark_text_ends_with?: string[] | null;
+                mark_text_contains?: string[] | null;
+                mark_text_pattern?: string[] | null;
+                mark_text_not_is?: string[] | null;
+                mark_text_not_word?: string[] | null;
+                mark_text_not_starts_with?: string[] | null;
+                mark_text_not_ends_with?: string[] | null;
+                mark_text_not_contains?: string[] | null;
+                mark_text_not_pattern?: string[] | null;
+                entity_id_not?: string[] | null;
+                entity_group_not?: string[] | null;
+                owner_id_not?: string[] | null;
+                trademark_ids_not?: string[] | null;
+                allow_partial?: boolean | null;
                 sort?: string;
                 status_primary?: ("pending" | "active" | "inactive" | "unknown" | "mixed")[] | null;
                 status_stage?: ("filed" | "examining" | "pending_publication" | "published" | "opposition_period" | "pending_opposition" | "pending_cancellation" | "pending_issuance" | "registered" | "allowed" | "abandoned" | "withdrawn" | "surrendered" | "refused" | "cancelled" | "invalidated" | "expired" | "unknown" | "mixed")[] | null;
@@ -13392,10 +13857,8 @@ export interface operations {
                 is_retracted?: boolean | null;
                 is_series_mark?: boolean | null;
                 international_registrations?: "grouped" | "expanded";
-                include?: "full_goods_services"[] | null;
+                include?: ("full_goods_services" | "match_details")[] | null;
                 fields?: string[] | null;
-                match?: "similar" | "exact" | "starts_with" | "ends_with" | "contains";
-                mark_text_not_contains?: string;
                 owner_publicly_traded?: boolean | null;
                 owner_has_lei?: boolean | null;
                 owner_ticker?: string;
@@ -13683,7 +14146,24 @@ export interface operations {
         parameters: {
             query?: {
                 q?: string;
-                strategies?: ("exact" | "phonetic" | "fuzzy" | "prefix")[] | null;
+                similarity?: ("identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[] | null;
+                mark_text_is?: string[] | null;
+                mark_text_word?: string[] | null;
+                mark_text_starts_with?: string[] | null;
+                mark_text_ends_with?: string[] | null;
+                mark_text_contains?: string[] | null;
+                mark_text_pattern?: string[] | null;
+                mark_text_not_is?: string[] | null;
+                mark_text_not_word?: string[] | null;
+                mark_text_not_starts_with?: string[] | null;
+                mark_text_not_ends_with?: string[] | null;
+                mark_text_not_contains?: string[] | null;
+                mark_text_not_pattern?: string[] | null;
+                entity_id_not?: string[] | null;
+                entity_group_not?: string[] | null;
+                owner_id_not?: string[] | null;
+                trademark_ids_not?: string[] | null;
+                allow_partial?: boolean | null;
                 sort?: string;
                 status_primary?: ("pending" | "active" | "inactive" | "unknown" | "mixed")[] | null;
                 status_stage?: ("filed" | "examining" | "pending_publication" | "published" | "opposition_period" | "pending_opposition" | "pending_cancellation" | "pending_issuance" | "registered" | "allowed" | "abandoned" | "withdrawn" | "surrendered" | "refused" | "cancelled" | "invalidated" | "expired" | "unknown" | "mixed")[] | null;
@@ -13767,10 +14247,8 @@ export interface operations {
                 is_retracted?: boolean | null;
                 is_series_mark?: boolean | null;
                 international_registrations?: "grouped" | "expanded";
-                include?: "full_goods_services"[] | null;
+                include?: ("full_goods_services" | "match_details")[] | null;
                 fields?: string[] | null;
-                match?: "similar" | "exact" | "starts_with" | "ends_with" | "contains";
-                mark_text_not_contains?: string;
                 owner_publicly_traded?: boolean | null;
                 owner_has_lei?: boolean | null;
                 owner_ticker?: string;
@@ -14130,7 +14608,24 @@ export interface operations {
         parameters: {
             query?: {
                 q?: string;
-                strategies?: ("exact" | "phonetic" | "fuzzy" | "prefix")[] | null;
+                similarity?: ("identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[] | null;
+                mark_text_is?: string[] | null;
+                mark_text_word?: string[] | null;
+                mark_text_starts_with?: string[] | null;
+                mark_text_ends_with?: string[] | null;
+                mark_text_contains?: string[] | null;
+                mark_text_pattern?: string[] | null;
+                mark_text_not_is?: string[] | null;
+                mark_text_not_word?: string[] | null;
+                mark_text_not_starts_with?: string[] | null;
+                mark_text_not_ends_with?: string[] | null;
+                mark_text_not_contains?: string[] | null;
+                mark_text_not_pattern?: string[] | null;
+                entity_id_not?: string[] | null;
+                entity_group_not?: string[] | null;
+                owner_id_not?: string[] | null;
+                trademark_ids_not?: string[] | null;
+                allow_partial?: boolean | null;
                 sort?: string;
                 status_primary?: ("pending" | "active" | "inactive" | "unknown" | "mixed")[] | null;
                 status_stage?: ("filed" | "examining" | "pending_publication" | "published" | "opposition_period" | "pending_opposition" | "pending_cancellation" | "pending_issuance" | "registered" | "allowed" | "abandoned" | "withdrawn" | "surrendered" | "refused" | "cancelled" | "invalidated" | "expired" | "unknown" | "mixed")[] | null;
@@ -14214,10 +14709,8 @@ export interface operations {
                 is_retracted?: boolean | null;
                 is_series_mark?: boolean | null;
                 international_registrations?: "grouped" | "expanded";
-                include?: "full_goods_services"[] | null;
+                include?: ("full_goods_services" | "match_details")[] | null;
                 fields?: string[] | null;
-                match?: "similar" | "exact" | "starts_with" | "ends_with" | "contains";
-                mark_text_not_contains?: string;
                 owner_publicly_traded?: boolean | null;
                 owner_has_lei?: boolean | null;
                 owner_ticker?: string;
@@ -14438,7 +14931,24 @@ export interface operations {
         parameters: {
             query?: {
                 q?: string;
-                strategies?: ("exact" | "phonetic" | "fuzzy" | "prefix")[] | null;
+                similarity?: ("identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[] | null;
+                mark_text_is?: string[] | null;
+                mark_text_word?: string[] | null;
+                mark_text_starts_with?: string[] | null;
+                mark_text_ends_with?: string[] | null;
+                mark_text_contains?: string[] | null;
+                mark_text_pattern?: string[] | null;
+                mark_text_not_is?: string[] | null;
+                mark_text_not_word?: string[] | null;
+                mark_text_not_starts_with?: string[] | null;
+                mark_text_not_ends_with?: string[] | null;
+                mark_text_not_contains?: string[] | null;
+                mark_text_not_pattern?: string[] | null;
+                entity_id_not?: string[] | null;
+                entity_group_not?: string[] | null;
+                owner_id_not?: string[] | null;
+                trademark_ids_not?: string[] | null;
+                allow_partial?: boolean | null;
                 sort?: string;
                 status_primary?: ("pending" | "active" | "inactive" | "unknown" | "mixed")[] | null;
                 status_stage?: ("filed" | "examining" | "pending_publication" | "published" | "opposition_period" | "pending_opposition" | "pending_cancellation" | "pending_issuance" | "registered" | "allowed" | "abandoned" | "withdrawn" | "surrendered" | "refused" | "cancelled" | "invalidated" | "expired" | "unknown" | "mixed")[] | null;
@@ -14522,10 +15032,8 @@ export interface operations {
                 is_retracted?: boolean | null;
                 is_series_mark?: boolean | null;
                 international_registrations?: "grouped" | "expanded";
-                include?: "full_goods_services"[] | null;
+                include?: ("full_goods_services" | "match_details")[] | null;
                 fields?: string[] | null;
-                match?: "similar" | "exact" | "starts_with" | "ends_with" | "contains";
-                mark_text_not_contains?: string;
                 owner_publicly_traded?: boolean | null;
                 owner_has_lei?: boolean | null;
                 owner_ticker?: string;
@@ -14599,7 +15107,7 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Entity too large. `error.reason` discriminates: `member_owners_too_large` (the entity resolved to more member owners than the cap; carries `member_count`/`member_count_limit`) or `family_graph_too_large` (the GLEIF family-graph walk exceeded its bound, fired by `?include_family=true`; carries `related_entity_limit`/`depth_limit`). */
+            /** @description Family graph too large: `?include_family=true` walked a family-tree larger than the bound (`error.reason` `family_graph_too_large`; carries `related_entity_limit`/`depth_limit`). There is no member-owner cap: an entity of any size lists without `include_family`. */
             422: {
                 headers: {
                     [name: string]: unknown;
@@ -14715,7 +15223,7 @@ export interface operations {
                     "application/json": components["schemas"]["ProceedingListResponse"];
                 };
             };
-            /** @description Missing filter or invalid params */
+            /** @description Missing filter or invalid params, including an unknown or planned (not live) `office_code` */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -14742,7 +15250,7 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Entity too large. `error.reason` is `member_owners_too_large` (`?party_entity_id=`/`?entity_id=` resolved to more member owners than the cap; carries `member_count`/`member_count_limit`). */
+            /** @description Two cases, told apart by `error.type`. `capability_not_available`: `office_code` names a live office whose proceedings Signa does not serve (`capabilities.proceedings` on `GET /v1/offices` is not `available`); the error carries `capability`, `capability_state` and `office_code`, no query is run and no credits are charged. `entity_too_large`: `error.reason` is `member_owners_too_large` (`?party_entity_id=`/`?entity_id=` resolved to more member owners than the cap; carries `member_count`/`member_count_limit`). */
             422: {
                 headers: {
                     [name: string]: unknown;
@@ -15074,7 +15582,7 @@ export interface operations {
     listDeadlines: {
         parameters: {
             query?: {
-                type?: ("renewal" | "declaration_of_use" | "combined_renewal_and_use" | "declaration_of_incontestability" | "restoration" | "international_renewal")[] | null;
+                type?: ("renewal" | "declaration_of_use" | "combined_renewal_and_use" | "declaration_of_incontestability" | "restoration" | "international_renewal" | "post_registration_oa_response")[] | null;
                 due_before?: string;
                 urgency?: "critical" | "upcoming" | "routine" | "in_grace" | "missed";
                 limit?: number;
@@ -16338,7 +16846,7 @@ export interface operations {
     listPortfolioDeadlines: {
         parameters: {
             query?: {
-                type?: ("renewal" | "declaration_of_use" | "combined_renewal_and_use" | "declaration_of_incontestability" | "restoration" | "international_renewal")[] | null;
+                type?: ("renewal" | "declaration_of_use" | "combined_renewal_and_use" | "declaration_of_incontestability" | "restoration" | "international_renewal" | "post_registration_oa_response")[] | null;
                 due_before?: string;
                 urgency?: "critical" | "upcoming" | "routine" | "in_grace" | "missed";
                 limit?: number;
@@ -16511,6 +17019,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
         };
     };
     retrieveAlert: {
@@ -16533,6 +17050,15 @@ export interface operations {
                     "application/json": components["schemas"]["Alert"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -16577,6 +17103,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -16637,11 +17172,16 @@ export interface operations {
                                 /** @description Present and `true` when the change diff was bounded (entries dropped past the max count, or an over-long from/to value replaced with a sentinel, or a byte-budget cap hit). Absent when the diff is complete. */
                                 diff_truncated?: boolean;
                             };
-                            /** @description Match metadata (why/how the mark matched the watch). Null for pure-filter / pre-v2 alerts that carry no match scoring. */
+                            /** @description Match metadata (why/how the mark matched the watch). Null for pure-filter / pre-v2 alerts that carry no match scoring. `score` is the engine score for the watch query, not the 0-100 search `relevance_score`. */
                             match: {
                                 reason: string | null;
                                 score: number | null;
                                 score_basis: string | null;
+                                /**
+                                 * @description Similarity tier of the matched mark, the same label a search hit carries as `match.tier` (identical, near_identical, similar, related). A retrieval category, not a measured edit distance. Null for filter-only watches, marks found only by their number, and alerts emitted before the field existed.
+                                 * @enum {string|null}
+                                 */
+                                tier: "identical" | "near_identical" | "similar" | "related" | null;
                             } | null;
                             trademark: components["schemas"]["AlertTrademark"];
                             deadline: {
@@ -16698,6 +17238,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
         };
     };
     listWatches: {
@@ -16722,6 +17271,15 @@ export interface operations {
                     "application/json": components["schemas"]["WatchList"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
         };
     };
     createWatch: {
@@ -16741,15 +17299,16 @@ export interface operations {
                     /** @enum {string} */
                     watch_type: "mark" | "portfolio" | "owner" | "class" | "similarity";
                     /**
-                     * @description Watch query JSON (max 50,000 bytes serialized, depth 5 — larger bodies are 400 `validation_error`). Similarity watches use `version: "v2"`, `q` (string), optional public-search `strategies` (`exact`, `phonetic`, `fuzzy`, `prefix`), optional `min_match_tier` (`exact`, `normalized`, `fuzzy`, `phonetic`), `filters`, and optional `trigger_events` (default: `trademark.created`, `trademark.updated`, `trademark.status_changed`; `trademark.retracted` / `trademark.corrected` are opt-in). `filters.offices` takes WIPO ST.3 codes (`US`, `EM`, …; legacy `uspto`/`euipo`/`EU` accepted); `filters.jurisdictions` without `filters.offices` is auto-translated to the live offices for those jurisdictions and is rejected with 400 `no_live_office` when none resolves. `score_threshold` is NOT accepted on write (400) — match scores are informational via `match_score` on alerts — and is never echoed on read.
+                     * @description Watch query JSON (max 50,000 bytes serialized, depth 5; larger bodies are 400 `validation_error`). `version` is required: `v1`, `v2` and `v3` are accepted, and a new or changed query is stored as a v3 similarity watch whatever `version` it sends (`version` is set to `v3`) unless it uses the deprecated keys below: `q` (string), optional `similarity` (the search channels: `identical`, `fuzzy`, `embedded`, `phonetic`, `lookalike`; default `identical,fuzzy,embedded,lookalike`, `identical` always on), optional `min_tier` (the weakest similarity tier that alerts: `identical`, `near_identical`, `similar`, `related`; default `related`, everything through), `filters`, and optional `trigger_events` (default: `trademark.created`, `trademark.updated`, `trademark.status_changed`; `trademark.retracted` / `trademark.corrected` are opt-in; `trademark.corrected` also covers a status Signa corrected, including a lapse or a reversal shown by office records that reached Signa late, which then never arrives as `trademark.status_changed` / `trademark.updated`). The search text filters (`mark_text_*`) and exclusions (`exclude`, `*_not`) are not accepted on watches. Deprecated until 2026-12-28: `strategies` (replaced by `similarity`) and `min_match_tier` (replaced by `min_tier`). A write that uses them is kept as a legacy watch with its original matching until it is re-saved without them, and each is reported in the response `deprecations`; sending old and new keys together is 400 `conflicting_params`. Stored watches keep the matching they were saved with; a PATCH whose query equals the stored one changes nothing, one that differs only where a write normalises it (such as offices added from jurisdictions, or code and ID casing) is saved in that form and not migrated (a legacy watch stays legacy), though the saved form can change what it matches (a jurisdictions-only watch is evaluated once offices are added), and a PATCH that changes it re-saves it under these rules. `filters.offices` takes WIPO ST.3 codes (`US`, `EM`, …; legacy `uspto`/`euipo`/`EU` accepted); `filters.jurisdictions` without `filters.offices` is auto-translated to the live offices for those jurisdictions and is rejected with 400 `no_live_office` when none resolves. `score_threshold` is NOT accepted on write (400), since match scores are informational via `match.score` on alerts, and is never echoed on read.
                      * @example {
-                     *       "version": "v2",
+                     *       "version": "v3",
                      *       "q": "acme",
-                     *       "strategies": [
-                     *         "exact",
-                     *         "fuzzy"
+                     *       "similarity": [
+                     *         "identical",
+                     *         "fuzzy",
+                     *         "phonetic"
                      *       ],
-                     *       "min_match_tier": "fuzzy",
+                     *       "min_tier": "similar",
                      *       "filters": {
                      *         "offices": [
                      *           "US"
@@ -16795,6 +17354,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Insufficient credits — `insufficient_credits_for_watch`: the pooled credit balance cannot fund the minimum monitoring window for a new watch (charged plans only). Extensions carry `credit_balance`, `credit_required`, `monitoring_daily_cost`, `required_days`. */
             402: {
                 headers: {
@@ -16862,6 +17430,15 @@ export interface operations {
                     "application/json": components["schemas"]["Watch"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -16903,6 +17480,15 @@ export interface operations {
                     };
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -16967,6 +17553,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Insufficient credits to fund the minimum monitoring window for newly added distinct trademarks. */
             402: {
                 headers: {
@@ -17036,6 +17631,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -17072,6 +17676,15 @@ export interface operations {
                     "application/pdf": string;
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -17124,6 +17737,15 @@ export interface operations {
                     "application/json": components["schemas"]["Watch"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -17158,6 +17780,15 @@ export interface operations {
                     "application/json": components["schemas"]["Watch"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -17200,6 +17831,15 @@ export interface operations {
                         object: "watch_preview";
                         estimated_match_count: number;
                         trial_window_days: number;
+                        /** @description The similarity channels the text query ran (identical always included). Null when the query has no q, and for a query that uses the deprecated keys (previewed as the legacy watch a create would keep). */
+                        similarity_applied: ("identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[] | null;
+                        /**
+                         * @description The weakest similarity tier that alerts (`related` admits everything). Null for a query that uses the deprecated keys, which keeps its `min_match_tier`.
+                         * @enum {string|null}
+                         */
+                        min_tier: "identical" | "near_identical" | "similar" | "related" | null;
+                        /** @description Present when the previewed query used a deprecated key (`strategies`, `min_match_tier`); the preview ran it as the legacy watch a create would keep. */
+                        deprecations?: components["schemas"]["WatchDeprecation"][];
                         /**
                          * @description Present only when estimated_match_count is not an exact count. `query_upper_bound`: the time budget ran out after the search but before the change check; the count is the marks that matched the query in the window plus the marks changed in the last 6 hours that the search index may not reflect yet, so it can only be too high. `lower_bound`: the search timed out or lost a shard, more than 10,000 marks matched the query in the window, the change check timed out, or the re-check of marks changed in the last 6 hours (which the search index may not reflect yet) could not finish; the count is the verified matches (0 if none), so it can only be too low. `candidacy_upper_bound`: a watch without a text query could not be fully evaluated (search unreachable, a very large change set, or the budget ran out); the count is the number of changed marks in the window.
                          * @enum {string}
@@ -17226,6 +17866,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Payload too large — the 256KB service-level query cap. NOT reachable over HTTP: the 50,000-byte / depth-5 bounded-JSON check on `query` runs first and answers 400 `validation_error`; only service/MCP callers can observe this status. */
             413: {
                 headers: {
@@ -17293,15 +17942,16 @@ export interface operations {
                         /** @enum {string} */
                         watch_type: "mark" | "portfolio" | "owner" | "class" | "similarity";
                         /**
-                         * @description Watch query JSON (max 50,000 bytes serialized, depth 5 — larger bodies are 400 `validation_error`). Similarity watches use `version: "v2"`, `q` (string), optional public-search `strategies` (`exact`, `phonetic`, `fuzzy`, `prefix`), optional `min_match_tier` (`exact`, `normalized`, `fuzzy`, `phonetic`), `filters`, and optional `trigger_events` (default: `trademark.created`, `trademark.updated`, `trademark.status_changed`; `trademark.retracted` / `trademark.corrected` are opt-in). `filters.offices` takes WIPO ST.3 codes (`US`, `EM`, …; legacy `uspto`/`euipo`/`EU` accepted); `filters.jurisdictions` without `filters.offices` is auto-translated to the live offices for those jurisdictions and is rejected with 400 `no_live_office` when none resolves. `score_threshold` is NOT accepted on write (400) — match scores are informational via `match_score` on alerts — and is never echoed on read.
+                         * @description Watch query JSON (max 50,000 bytes serialized, depth 5; larger bodies are 400 `validation_error`). `version` is required: `v1`, `v2` and `v3` are accepted, and a new or changed query is stored as a v3 similarity watch whatever `version` it sends (`version` is set to `v3`) unless it uses the deprecated keys below: `q` (string), optional `similarity` (the search channels: `identical`, `fuzzy`, `embedded`, `phonetic`, `lookalike`; default `identical,fuzzy,embedded,lookalike`, `identical` always on), optional `min_tier` (the weakest similarity tier that alerts: `identical`, `near_identical`, `similar`, `related`; default `related`, everything through), `filters`, and optional `trigger_events` (default: `trademark.created`, `trademark.updated`, `trademark.status_changed`; `trademark.retracted` / `trademark.corrected` are opt-in; `trademark.corrected` also covers a status Signa corrected, including a lapse or a reversal shown by office records that reached Signa late, which then never arrives as `trademark.status_changed` / `trademark.updated`). The search text filters (`mark_text_*`) and exclusions (`exclude`, `*_not`) are not accepted on watches. Deprecated until 2026-12-28: `strategies` (replaced by `similarity`) and `min_match_tier` (replaced by `min_tier`). A write that uses them is kept as a legacy watch with its original matching until it is re-saved without them, and each is reported in the response `deprecations`; sending old and new keys together is 400 `conflicting_params`. Stored watches keep the matching they were saved with; a PATCH whose query equals the stored one changes nothing, one that differs only where a write normalises it (such as offices added from jurisdictions, or code and ID casing) is saved in that form and not migrated (a legacy watch stays legacy), though the saved form can change what it matches (a jurisdictions-only watch is evaluated once offices are added), and a PATCH that changes it re-saves it under these rules. `filters.offices` takes WIPO ST.3 codes (`US`, `EM`, …; legacy `uspto`/`euipo`/`EU` accepted); `filters.jurisdictions` without `filters.offices` is auto-translated to the live offices for those jurisdictions and is rejected with 400 `no_live_office` when none resolves. `score_threshold` is NOT accepted on write (400), since match scores are informational via `match.score` on alerts, and is never echoed on read.
                          * @example {
-                         *       "version": "v2",
+                         *       "version": "v3",
                          *       "q": "acme",
-                         *       "strategies": [
-                         *         "exact",
-                         *         "fuzzy"
+                         *       "similarity": [
+                         *         "identical",
+                         *         "fuzzy",
+                         *         "phonetic"
                          *       ],
-                         *       "min_match_tier": "fuzzy",
+                         *       "min_tier": "similar",
                          *       "filters": {
                          *         "offices": [
                          *           "US"
@@ -17405,6 +18055,8 @@ export interface operations {
                             };
                             created_at: string;
                             updated_at: string;
+                            /** @description Present on create, update and bulk responses when the written query used a deprecated key: `strategies` (replaced by `similarity`) or `min_match_tier` (replaced by `min_tier`). The watch is kept as a legacy watch with its original matching until it is re-saved without them. Each entry names the key, its replacement and the date the old key stops being accepted. */
+                            deprecations?: components["schemas"]["WatchDeprecation"][];
                         }[];
                         request_id: string;
                     };
@@ -17419,6 +18071,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Insufficient credits — `insufficient_credits_for_watch`: the pooled credit balance cannot fund the minimum monitoring window for a new watch (charged plans only). Extensions carry `credit_balance`, `credit_required`, `monitoring_daily_cost`, `required_days`. */
             402: {
                 headers: {
@@ -17484,6 +18145,15 @@ export interface operations {
                     "application/json": components["schemas"]["MonitoringStatus"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
         };
     };
     listWebhookEndpoints: {
@@ -17516,6 +18186,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
         };
     };
     createWebhookEndpoint: {
@@ -17533,7 +18212,7 @@ export interface operations {
                 "application/json": {
                     url: string;
                     description?: string;
-                    /** @description Events delivered to this endpoint. Accepted values: alert.created, trademark.status_changed, office_action.issued. trademark.status_changed and office_action.issued are delivered only for marks in one of the organization's portfolios. alert.created follows watch scope. */
+                    /** @description Events delivered to this endpoint. Accepted values: alert.created, trademark.status_changed, trademark.corrected, office_action.issued. trademark.status_changed, trademark.corrected and office_action.issued are delivered only for marks in one of the organization's portfolios; trademark.status_changed also delivers trademark.corrected. alert.created follows watch scope. */
                     enabled_events: string[];
                     /** @description Limit this endpoint to events on marks in this portfolio (ptf_*). Applies to every event type, alert.created included: an alert is delivered only when its matched mark was a member of the portfolio at event time. */
                     portfolio_id?: string | null;
@@ -17562,6 +18241,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Portfolio not found */
             404: {
                 headers: {
@@ -17593,6 +18281,15 @@ export interface operations {
                     "application/json": components["schemas"]["WebhookEndpoint"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -17634,6 +18331,15 @@ export interface operations {
                     };
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -17662,7 +18368,7 @@ export interface operations {
                 "application/json": {
                     url?: string;
                     description?: string | null;
-                    /** @description Events delivered to this endpoint. Accepted values: alert.created, trademark.status_changed, office_action.issued. trademark.status_changed and office_action.issued are delivered only for marks in one of the organization's portfolios. alert.created follows watch scope. */
+                    /** @description Events delivered to this endpoint. Accepted values: alert.created, trademark.status_changed, trademark.corrected, office_action.issued. trademark.status_changed, trademark.corrected and office_action.issued are delivered only for marks in one of the organization's portfolios; trademark.status_changed also delivers trademark.corrected. alert.created follows watch scope. */
                     enabled_events?: string[];
                     /** @description Limit this endpoint to events on marks in this portfolio (ptf_*), or null to clear. Applies to every event type, alert.created included: an alert is delivered only when its matched mark was a member of the portfolio at event time. */
                     portfolio_id?: string | null;
@@ -17693,6 +18399,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -17729,6 +18444,15 @@ export interface operations {
                     "application/json": components["schemas"]["WebhookEndpoint"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -17777,6 +18501,15 @@ export interface operations {
                     };
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -17830,6 +18563,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -17862,6 +18604,15 @@ export interface operations {
                     "application/json": components["schemas"]["WebhookDelivery"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -17902,6 +18653,15 @@ export interface operations {
                     };
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -17968,6 +18728,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Missing events:read scope */
             403: {
                 headers: {
@@ -18026,6 +18795,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Missing events:read scope */
             403: {
                 headers: {
@@ -19284,6 +20062,11 @@ export interface operations {
                      * @enum {string}
                      */
                     interval?: "monthly" | "annual";
+                    /**
+                     * @description Undo only: `plan` and `interval` name the current plan, and the request may only cancel the change scheduled here (`applied`, nothing charged). If no such change is pending (it already took effect or was cancelled), the request is refused 409 `plan_change_blocked` (`scheduled_change_not_pending`) and nothing is changed or charged. Omitted or false: an ordinary plan change.
+                     * @example true
+                     */
+                    undo_scheduled_change?: boolean;
                 };
             };
         };
@@ -19333,7 +20116,7 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description The organization has no live subscription to change (type `no_live_subscription`; subscribe through checkout); the subscription cannot take the change (type `plan_change_blocked`, with `reason`: `cancelling` — set to cancel; `scheduled` — a change is already scheduled; `no_period_end`; `not_self_serve` — an enterprise contract; `unresolved_price`; `pending_payment` — a different change is parked awaiting its payment; a repeat of the SAME parked change answers 200 pending_payment with the same invoice); or billing changes are paused while a payment dispute is open or after it was lost (type `billing_hold`; contact support); or the organization is suspended for an unpaid subscription invoice (type `billing_suspended`; the plan comes back when the invoice is paid). A past-due organization whose plan is still paid for can change plan. */
+            /** @description The organization has no live subscription to change (type `no_live_subscription`; subscribe through checkout); the subscription cannot take the change (type `plan_change_blocked`, with `reason`: `cancelling` — set to cancel; `scheduled` — the subscription is managed by a schedule Signa did not set up (contact support); `no_period_end`; `not_self_serve` — an enterprise contract; `unresolved_price`; `pending_payment` — a different change is parked awaiting its payment; a repeat of the SAME parked change answers 200 pending_payment with the same invoice; `scheduled_change_pending` — an upgrade (or a longer interval) while a change made here is scheduled: undo it first by requesting the current plan and interval; `scheduled_change_not_pending` — `undo_scheduled_change` was set but no change made here is pending, nothing was changed or charged); or billing changes are paused while a payment dispute is open or after it was lost (type `billing_hold`; contact support); or the organization is suspended for an unpaid subscription invoice (type `billing_suspended`; the plan comes back when the invoice is paid). A past-due organization whose plan is still paid for can change plan. */
             409: {
                 headers: {
                     [name: string]: unknown;