Previous value: -"Companies House company number. The identifier itself is 1-8 letters/digits; surrounding whitespace is ignored (which is why maxLength is 10), but the value must not contain internal spaces. Short numeric values are zero-padded to 8 characters. A whitespace-only or over-long value is rejected as INVALID_INPUT before any payment or upstream call."New value: +"Companies House company number. Accepted shapes are the register's own — 1-8 digits (zero-padded to 8, e.g. 445790 → 00445790), one letter + 7 digits (R0000001), two letters + 6 digits (SC002180, NI000001, OC123456, OE000001), or the registered-society suffix forms (two letters + 5 digits + 1 letter; two letters + 4 digits + 2 letters). Case-insensitive; surrounding whitespace is ignored (which is why maxLength is 10); internal spaces and punctuation are not accepted. Any other value (for example PROBE) is rejected as INVALID_INPUT before payment and before any upstream call."

Previous value: -"^\\s*[A-Za-z0-9]{1,8}\\s*$"New value: +"^\\s*(?:[0-9]{1,8}|[A-Za-z][0-9]{7}|[A-Za-z]{2}[0-9]{6}|[A-Za-z]{2}[0-9]{5}[A-Za-z]|[A-Za-z]{2}[0-9]{4}[A-Za-z]{2})\\s*$"

Removed value: -{
-  "description": "Companies House company number. The identifier itself is 1-8 letters/digits; surrounding whitespace is ignored (which is why maxLength is 10), but the value must not contain internal spaces. Short numeric values are zero-padded to 8 characters. A whitespace-only or over-long value is rejected as INVALID_INPUT before any payment or upstream call.",
-  "maxLength": 10,
-  "minLength": 1,
-  "pattern": "^\\s*[A-Za-z0-9]{1,8}\\s*$",
-  "type": "string"
-}

Added value: +{
+  "description": "Companies House company number. The identifier itself is 1-8 letters/digits; surrounding whitespace is ignored (which is why maxLength is 10), but the value must not contain internal spaces. Short numeric values are zero-padded to 8 characters. A whitespace-only or over-long value is rejected as INVALID_INPUT before any payment or upstream call.",
+  "maxLength": 10,
+  "minLength": 1,
+  "pattern": "^\\s*[A-Za-z0-9]{1,8}\\s*$",
+  "type": "string"
+}

Previous value: -[
-  "companyNumber"
-]New value: +[
+  "company_number"
+]

Previous value: -"Maximum PSCs to return per page (1-100). Default 25. Eckari reads up to three register pages of 100 entries to fill this after the ceased filter is applied; if the limit is still unmet, has_more is true and next_offset says where to resume."New value: +"Maximum PSCs to return per page (1-100). Default 10. Eckari reads up to three register pages of 100 entries to fill this after the ceased filter is applied; if the limit is still unmet, page.has_more is true and page.next_offset says where to resume."

Previous value: -"Zero-based index into the register's own PSC list (not into the filtered result). Pass back the next_offset from the previous response to page."New value: +"Zero-based index into the register's own PSC list (not into the filtered result). Pass back page.next_offset from the previous response to page."

Removed value: -false

Previous value: -"Contains public sector information licensed under the Open Government Licence v3.0 (Companies House)."New value: +"Capability output; full JSON Schema at https://api.eckari.com/v1/capabilities/company.uk.owners"

Removed value: -{
-  "active_count": {
-    "description": "Register-wide count of PSC entries with no cessation date. Not a count of the returned page.",
-    "type": "integer"
-  },
-  "active_statement_count": {
-    "description": "Number of statements with no cessation date. Unaffected by include_ceased.",
-    "type": "integer"
-  },
-  "ceased_count": {
-    "description": "Register-wide count of ceased PSC entries. Not a count of the returned page.",
-    "type": "integer"
-  },
-  "company_number": {
-    "type": "string"
-  },
-  "exemptions": {
-    "description": "PSC exemptions recorded against the company. This is where the register records a listed company's exemption from the PSC regime (DTR5 / voting shares admitted to a regulated market) — it is a separate register collection from statements, and it is the reason a listed PLC discloses no PSC. Historic (closed) exemptions are returned too, flagged by is_current false.",
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "description": {
-          "description": "Official exemption text from the Companies House exemption_descriptions enumeration. Falls back to the raw key when unknown; never invented.",
-          "type": "string"
-        },
-        "exempt_from": {
-          "format": "date",
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "exempt_to": {
-          "description": "Date the exemption ended; null while it remains in force.",
-          "format": "date",
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "exemption_type": {
-          "description": "Companies House exemption key (e.g. psc-exempt-as-trading-on-uk-regulated-market, disclosure-transparency-rules-chapter-five-applies).",
-          "type": "string"
-        },
-        "is_current": {
-          "description": "Derived; true when the register records no end date for the exemption.",
-          "type": "boolean"
-        }
-      },
-      "required": [
-        "exemption_type",
-        "description",
-        "exempt_from",
-        "exempt_to",
-        "is_current"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  },
-  "has_more": {
-    "description": "Derived; true when PSC entries matching the current filter remain beyond this page — either because more matches were read than limit allows, or because the register list was not exhausted within the three-page read budget. owners.length < limit is NOT a valid end-of-list test, and neither is comparing against total_results or active_count, which are register-wide.",
-    "type": "boolean"
-  },
-  "next_offset": {
-    "description": "Derived; the offset to pass to the next request to continue after the last PSC returned. Null when has_more is false.",
-    "type": [
-      "integer",
-      "null"
-    ]
-  },
-  "offset": {
-    "description": "The register index this page started at (the requested offset).",
-    "type": "integer"
-  },
-  "owners": {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "address": {
-          "additionalProperties": false,
-          "properties": {
-            "address_line_1": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "address_line_2": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "care_of": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "country": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "locality": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "po_box": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "postal_code": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "premises": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "region": {
-              "type": [
-                "string",
-                "null"
-              ]
-            }
-          },
-          "type": [
-            "object",
-            "null"
-          ]
-        },
-        "ceased_on": {
-          "format": "date",
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "country_of_residence": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "date_of_birth": {
-          "additionalProperties": false,
-          "properties": {
-            "month": {
-              "type": "integer"
-            },
-            "year": {
-              "type": "integer"
-            }
-          },
-          "required": [
-            "month",
-            "year"
-          ],
-          "type": [
-            "object",
-            "null"
-          ]
-        },
-        "identification": {
-          "additionalProperties": false,
-          "description": "Corporate/legal-person identification where applicable.",
-          "properties": {
-            "country_registered": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "legal_authority": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "legal_form": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "place_registered": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "registration_number": {
-              "type": [
-                "string",
-                "null"
-              ]
-            }
-          },
-          "type": [
-            "object",
-            "null"
-          ]
-        },
-        "is_active": {
-          "description": "Derived; true when the register records no cessation date for this PSC entry. It describes the entry, not the company — a dissolved company can still carry a PSC entry with no cessation date, so check company.uk.status for the company's own state.",
-          "type": "boolean"
-        },
-        "is_sanctioned": {
-          "description": "Register-declared flag, passed through unchanged. Companies House only ever populates it for beneficial owners on the Register of Overseas Entities, where the filer declares whether the person is designated under UK sanctions legislation; it is null for every other PSC entry and null does NOT mean 'not sanctioned'. This is NOT a sanctions screening result: Eckari runs no screening, checks no list and infers nothing. Screen against an authoritative sanctions source before relying on it.",
-          "type": [
-            "boolean",
-            "null"
-          ]
-        },
-        "kind": {
-          "description": "PSC kind (e.g. individual-person-with-significant-control, corporate-entity-person-with-significant-control, legal-person-with-significant-control, super-secure-person-with-significant-control, or the *-beneficial-owner variants for registered overseas entities).",
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "name": {
-          "description": "PSC name as published. Null only for super-secure entries, where the register withholds the individual's particulars.",
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "nationality": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "natures_of_control": {
-          "description": "Companies House natures_of_control codes exactly as published (e.g. ownership-of-shares-75-to-100-percent, voting-rights-25-to-50-percent, right-to-appoint-and-remove-directors, significant-influence-or-control). Stable keys for machine matching.",
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "natures_of_control_descriptions": {
-          "description": "Official Companies House text for each natures_of_control code, from the register's published psc_descriptions enumeration, in the same order and of the same length as natures_of_control (e.g. \"The person holds, directly or indirectly, more than 75% of the shares in the company.\"). An unrecognised future code echoes back as itself; never invented.",
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "notified_on": {
-          "format": "date",
-          "type": [
-            "string",
-            "null"
-          ]
-        }
-      },
-      "required": [
-        "name",
-        "kind",
-        "is_active",
-        "notified_on",
-        "ceased_on",
-        "natures_of_control",
-        "natures_of_control_descriptions",
-        "is_sanctioned"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  },
-  "ownership_status": {
-    "description": "Single derived answer to \"does this company disclose owners, and if not, why not?\". Precedence, highest first. (1) pscs_listed — at least one active PSC entry is listed (this also covers the Register of Overseas Entities statement all-beneficial-owners-identified, which is meaningful only alongside listed entries). (2) exempt_listed_company — a current PSC exemption, or an active statement whose key starts psc-exempt-. (3) no_psc_declared — an active statement no-individual-or-entity-with-signficant-control (or its -partnership form), or the Register of Overseas Entities statement no-beneficial-owner-identified: the entity positively declares it has no registrable person. (4) psc_not_identified — an active statement saying an owner exists but the register does not (yet) identify them: psc-exists-but-not-identified, psc-details-not-confirmed, steps-to-find-psc-not-yet-completed, psc-contacted-but-no-response, psc-has-failed-to-confirm-changed-details, restrictions-notice-issued-to-psc, awaiting-confirmation-from-psc, their -partnership forms, the Register of Overseas Entities keys at-least-one-beneficial-owner-unidentified and information-not-provided-for-at-least-one-beneficial-owner (and the combined form), and all-beneficial-owners-identified filed with no PSC entry on the register. (5) super_secure — an active super-secure statement, or an active PSC entry the register marks super-secure, where the individual's particulars are withheld. (6) no_information — the register holds no PSC entry, no active statement and no exemption at all. Any other active statement key, including one the register publishes in future, is reported as psc_not_identified, so no_information is never returned while the register is explaining itself. An empty owners list never on its own means the company has no owner. Paging caveat: for a company whose every active PSC entry is super-secure, a page that skips past those entries reports pscs_listed rather than super_secure — both are truthful (the entry is listed), and no page can turn a company with disclosed PSCs into super_secure.",
-    "enum": [
-      "pscs_listed",
-      "exempt_listed_company",
-      "no_psc_declared",
-      "psc_not_identified",
-      "super_secure",
-      "no_information"
-    ],
-    "type": "string"
-  },
-  "statements": {
-    "description": "PSC statements filed against the company — the register's own explanation of why a PSC entry is absent or incomplete (no registrable person, PSC not identified, restrictions notice, super-secure, and the Register of Overseas Entities beneficial-owner statements). Ceased statements are omitted unless include_ceased is true. This collection is fetched whole, not paged by limit/offset, so ownership_status does not drift between pages.",
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "ceased_on": {
-          "format": "date",
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "description": {
-          "description": "Official statement text from the Companies House psc_descriptions enumeration. Falls back to the raw key when the register publishes a key we do not yet carry; never invented.",
-          "type": "string"
-        },
-        "linked_psc_name": {
-          "description": "Name of the PSC the statement refers to",
-          "type": [
-            "string",
-            "null"
-          ],
-          "where the register links one.": null
-        },
-        "notified_on": {
-          "format": "date",
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "statement": {
-          "description": "Companies House statement key (e.g. no-individual-or-entity-with-signficant-control, psc-exists-but-not-identified, restrictions-notice-issued-to-psc, no-beneficial-owner-identified).",
-          "type": "string"
-        }
-      },
-      "required": [
-        "statement",
-        "description",
-        "notified_on",
-        "ceased_on",
-        "linked_psc_name"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  },
-  "total_results": {
-    "description": "Register-wide count of PSC entries for this company. Not a count of the returned page.",
-    "type": "integer"
-  }
-}

Removed value: -[
-  "company_number",
-  "total_results",
-  "active_count",
-  "ceased_count",
-  "offset",
-  "owners",
-  "has_more",
-  "next_offset",
-  "statements",
-  "active_statement_count",
-  "exemptions",
-  "ownership_status"
-]

Added value: +{
+  "format": "uri",
+  "type": "string"
+}

Added value: +"date-time"

Added value: +[
+  "capability",
+  "version",
+  "retrieved_at",
+  "source",
+  "freshness",
+  "request_id"
+]