UK Due Diligence

{'type': 'object', 'required': ['charity_number'], 'properties': {'charity_number': {'type': 'string', 'maxLength': 20, 'minLength': 1, 'description': "Charity Commission registration number (e.g. '1234567'). Returned by charity_search."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['charity_number'], 'properties': {'address': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Registered address of the charity (joined address lines).'}, 'insolvent': {'type': 'boolean', 'default': False, 'description': 'True if the charity is flagged as insolvent.'}, 'reg_status': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Registration status code ('R', 'RM')."}, 'charity_name': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Registered charity name.'}, 'charity_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Charity type.'}, 'latest_income': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'default': None, 'description': 'Latest filed annual income in GBP.'}, 'trustee_names': {'type': 'array', 'items': {'type': 'object', 'properties': {'trustee_name': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Trustee name.'}}, 'description': 'A single charity trustee record.'}, 'description': 'Trustees on record. Truncated to 30 entries.'}, 'charity_number': {'type': 'string', 'description': 'Charity registration number.'}, 'who_what_where': {'type': 'array', 'items': {'type': 'object', 'properties': {'classification_desc': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Classification description text.'}, 'classification_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Classification axis: 'What', 'Who', or 'Where'."}}, 'description': 'Who/What/Where classification descriptor.'}, 'description': 'Who/What/Where classification entries. The list may be truncated truncated to 50 entries.'}, 'reg_status_label': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Human-readable registration status.'}, 'in_administration': {'type': 'boolean', 'default': False, 'description': 'True if the charity is in administration.'}, 'latest_expenditure': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'default': None, 'description': 'Latest filed annual expenditure in GBP.'}, 'trustee_names_total': {'type': 'integer', 'default': 0, 'description': 'Total trustees upstream before truncation.'}, 'date_of_registration': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Date of first registration.'}, 'who_what_where_total': {'type': 'integer', 'default': 0, 'description': 'Total classification entries upstream before truncation.'}, 'charity_co_reg_number': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Companies House number for charities also registered as companies (Charitable Incorporated Organisations, etc.).'}, 'countries_of_operation': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Countries the charity operates in (capped at 10 upstream).'}, 'trustee_names_truncated': {'type': 'boolean', 'default': False, 'description': 'True if the trustee list was truncated.'}, 'who_what_where_truncated': {'type': 'boolean', 'default': False, 'description': 'True if the classification list was truncated.'}}, 'description': 'Full Charity Commission profile for a single charity.'}

{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Max items to return in this page. Default 20; raise to 100 for bulk views.'}, 'query': {'type': 'string', 'maxLength': 200, 'minLength': 2, 'description': 'Charity name or keyword to search for'}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 10000, 'minimum': 0, 'description': 'Number of items to skip before this page. Default 0.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['query', 'total', 'offset', 'limit', 'returned', 'has_more'], 'properties': {'limit': {'type': 'integer', 'description': 'Max items requested for this page.'}, 'query': {'type': 'string', 'description': 'Search term applied.'}, 'total': {'type': 'integer', 'description': 'Total matches returned by upstream.'}, 'offset': {'type': 'integer', 'description': 'Number of items skipped before this page (client-side).'}, 'has_more': {'type': 'boolean', 'description': 'True if more items may exist beyond this page. Re-call with offset=offset+returned to continue.'}, 'returned': {'type': 'integer', 'description': 'Items actually returned on this page.'}, 'charities': {'type': 'array', 'items': {'type': 'object', 'properties': {'reg_status': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Registration status code as returned upstream: 'R' registered, 'RM' removed."}, 'charity_name': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Registered charity name.'}, 'charity_number': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Charity Commission registration number. Pass to charity_profile for the full record.'}, 'reg_status_label': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Human-readable registration status ('Registered', 'Removed')."}, 'date_of_registration': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Date of first registration (ISO YYYY-MM-DD).'}}, 'description': 'A single hit in a Charity Commission name search.'}, 'description': 'Matching charity records.'}}, 'description': 'Paginated result of a Charity Commission name search.'}

{'type': 'object', 'required': ['company_number'], 'properties': {'company_number': {'type': 'string', 'maxLength': 10, 'minLength': 1, 'description': "Companies House company number (8 digits, e.g. '03782379'). Returned by company_search."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['company_number', 'total_count'], 'properties': {'charges': {'type': 'array', 'items': {'type': 'object', 'required': ['charge_number'], 'properties': {'links': {'type': 'object', 'description': 'Upstream relational links, e.g. links.self = charge record path.', 'additionalProperties': True}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Charge status as returned upstream (e.g. 'outstanding', 'part-satisfied', 'fully-satisfied')."}, 'created_on': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Date the charge was created (ISO YYYY-MM-DD).'}, 'charge_code': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Human-readable charge ID (e.g. '063334690005'). Absent on some older charges (e.g. pre-2006 debentures) — use charge_number as the reliable identifier."}, 'particulars': {'anyOf': [{'type': 'object', 'properties': {'type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Particulars entry type as returned by CH (e.g. 'brief-description', 'short-particulars')."}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Free-text description of what the charge covers, where filed.'}, 'contains_fixed_charge': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}], 'default': None, 'description': 'True if the charge includes a fixed charge.'}, 'contains_floating_charge': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}], 'default': None, 'description': 'True if the charge includes a floating charge.'}, 'contains_negative_pledge': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}], 'default': None, 'description': 'True if the charge includes a negative pledge (restricting further charges).'}, 'floating_charge_covers_all': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}], 'default': None, 'description': 'True if the floating charge covers the whole undertaking/all assets.'}}, 'description': 'What a charge covers — free text and/or boolean flags.\n\nField presence varies by charge age/type: pre-2006 debentures often\ncarry only type/description with no boolean flags; MR01-style charges\n(2013+) often carry only the boolean flags with no free text. Every\nfield is optional — do not assume any subset is always present.'}, {'type': 'null'}], 'default': None, 'description': 'What the charge covers — free text and/or boolean flags, depending on charge age/type.'}, 'delivered_on': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Date the charge was delivered/registered (ISO YYYY-MM-DD).'}, 'satisfied_on': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Date the charge was satisfied, or null if still live.'}, 'transactions': {'type': 'array', 'items': {'type': 'object', 'properties': {'links': {'type': 'object', 'description': 'Upstream relational links, e.g. links.filing = filing-history path.', 'additionalProperties': True}, 'filing_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Filing type (e.g. 'create-charge-with-deed', 'charge-satisfaction')."}, 'delivered_on': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Date this filing was delivered (ISO YYYY-MM-DD).'}}, 'description': 'A filing event against a charge (creation, satisfaction, etc.).'}, 'description': "Filing events against this charge — creation, satisfaction, etc. Satisfaction is represented here (filing_type='charge-satisfaction') and via satisfied_on, not a separate 'release' concept."}, 'charge_number': {'type': 'integer', 'description': 'Sequential charge number for this company. Always present, unlike charge_code.'}, 'classification': {'anyOf': [{'type': 'object', 'properties': {'type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Classification type as returned by CH (e.g. 'charge-description')."}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Human-readable charge type (e.g. 'A registered charge', 'Debenture')."}}, 'description': "Charge type classification (e.g. 'A registered charge', 'Debenture')."}, {'type': 'null'}], 'default': None, 'description': 'Charge type classification.'}, 'secured_details': {'anyOf': [{'type': 'object', 'properties': {'type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Secured-details entry type as returned by CH (e.g. 'amount-secured')."}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Free-text description of the amount/obligation secured.'}}, 'description': "Free-text 'amount secured' description.\n\nSeen only on older/pre-2006 charge filings — absent on newer\nMR01-style charges, which express scope entirely through\nChargeParticulars' boolean flags instead. Optional, not assume-present."}, {'type': 'null'}], 'default': None, 'description': 'Free-text amount-secured description. Present only on some older charges.'}, 'persons_entitled': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Name of the person or entity entitled under this charge, as filed.'}}, 'description': 'A secured party named on a charge.'}, 'description': 'Secured parties named on this charge.'}}, 'description': "A single Companies House charge (secured debt registration).\n\nSatisfaction is represented via satisfied_on and a transactions[]\nentry with filing_type == 'charge-satisfaction' — there is no\nseparate 'release' concept upstream, so none is invented here."}, 'description': 'Every charge, current and historic.'}, 'total_count': {'type': 'integer', 'description': 'Total charges returned.'}, 'company_number': {'type': 'string', 'description': 'Companies House company number.'}, 'satisfied_count': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Upstream count of satisfied charges, or null if not provided.'}, 'unfiltered_count': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Upstream unfiltered charge count, or null if not provided.'}, 'part_satisfied_count': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Upstream count of part-satisfied charges, or null if not provided.'}}, 'description': 'Complete charge history for a company.'}

{'type': 'object', 'required': ['document_metadata_url'], 'properties': {'mime_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Which content representation to select, e.g. 'application/pdf'. Omit when the document has only one representation (the near-universal case) — it is auto-selected. Required if the document has more than one; omitting it in that case returns a validation error listing the choices."}, 'document_metadata_url': {'type': 'string', 'maxLength': 500, 'description': "The document_metadata URL from a filing's links.document_metadata (returned by company_filing_history) — pass it through verbatim, not a document_id. Must be an exact https://document-api.company-information.service.gov.uk/document/{id} URL."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['company_number'], 'properties': {'category': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}], 'default': None, 'description': "Filter by CH filing category — comma-separated for multiple, e.g. 'mortgage' or 'mortgage,officers'. Omit for all categories. Common values: accounts, confirmation-statement, officers, address, capital, mortgage, persons-with-significant-control, incorporation, insolvency, resolution, annual-return, change-of-name, change-of-constitution, gazette, miscellaneous."}, 'start_index': {'type': 'integer', 'default': 0, 'minimum': 0, 'description': 'Pagination offset. Default 0. Re-call with start_index=start_index+returned while has_more is true.'}, 'company_number': {'type': 'string', 'maxLength': 10, 'minLength': 1, 'description': "Companies House company number (8 digits, e.g. '03782379'). Returned by company_search."}, 'items_per_page': {'type': 'integer', 'default': 100, 'maximum': 100, 'minimum': 1, 'description': 'Results per page (Companies House caps at 100 regardless of a higher value). Default 100.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['company_number', 'total_count', 'start_index', 'items_per_page', 'returned', 'has_more'], 'properties': {'note': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Advisory note, e.g. suggesting a category filter when total_count is large and no category was applied. Informational only — never a truncation.'}, 'filings': {'type': 'array', 'items': {'type': 'object', 'required': ['transaction_id', 'type'], 'properties': {'date': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Filing/delivery date (ISO YYYY-MM-DD).'}, 'type': {'type': 'string', 'description': "CH filing form code (e.g. 'AA', 'CS01', 'MR04', 'CH01', 'RESOLUTIONS')."}, 'links': {'type': 'object', 'description': 'Upstream relational links. links.self is always present; links.document_metadata (Document API URL) is present on most but not all filings — absent on some pre-2008 filings.', 'additionalProperties': True}, 'pages': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Page count of the underlying filed document (not filing-history pagination).'}, 'barcode': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'CH barcode for this filing. Absent on many older filings.'}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Filing category (e.g. 'accounts', 'mortgage', 'officers', 'insolvency', 'resolution')."}, 'action_date': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Effective date of the underlying event, where distinct from the filing date (e.g. a change filed weeks after it took effect).'}, 'annotations': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': 'CH clarification notes attached to this filing after the fact.'}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Filing description slug as returned by CH (e.g. 'incorporation-company'), not prose."}, 'paper_filed': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}], 'default': None, 'description': 'True if filed on paper rather than electronically.'}, 'resolutions': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': 'Nested resolution filings, where this entry is a RESOLUTIONS bundle.'}, 'subcategory': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Filing subcategory as returned upstream — usually a string, occasionally a list of strings.'}, 'transaction_id': {'type': 'string', 'description': 'Companies House filing transaction ID. Path segment in links.self.'}, 'associated_filings': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': 'Other filings bundled with this one (e.g. a same-day statement of capital).'}, 'description_values': {'type': 'object', 'description': 'Free-form values referenced by the description slug. Keys vary entirely by filing type.', 'additionalProperties': True}}, 'description': 'A single Companies House filing-history entry.\n\nresolutions/associated_filings/annotations are nested filing-like\ndicts (their own category/type/description/description_values) but\ncarry no transaction_id or links of their own — not independently\ndocument-retrievable — so they are passed through raw rather than\nmodeled. subcategory is usually a string but has been observed as a\nlist of strings upstream (e.g. ["compulsory", "court-order"]);\npreserved as whichever shape upstream sent, not normalized.'}, 'description': 'Filings on this page.'}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'The category filter applied to this query, or null if unfiltered.'}, 'has_more': {'type': 'boolean', 'description': 'True if start_index + returned < total_count.'}, 'returned': {'type': 'integer', 'description': 'Filings returned on this page.'}, 'start_index': {'type': 'integer', 'description': 'Pagination offset used for this page.'}, 'total_count': {'type': 'integer', 'description': 'Total filings matching this query (across all pages).'}, 'company_number': {'type': 'string', 'description': 'Companies House company number.'}, 'items_per_page': {'type': 'integer', 'description': 'Page size actually used (CH caps at 100 regardless of a higher request).'}, 'filing_history_status': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Upstream filing-history status (e.g. 'filing-history-available')."}}, 'description': "One page of Companies House filing-history results for a company.\n\nNot an auto-fetch-all collection like officers/PSC/charges — a\ncompany's filing history is unbounded in practice (a long-lived PLC\ncan carry thousands of filings, multiple megabytes serialized), so\npagination is exposed to the caller rather than hidden. Re-call with\nstart_index=start_index+returned while has_more is true."}

{'type': 'object', 'required': ['company_number'], 'properties': {'start_index': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Ignored — pagination is handled internally. Only accepted to avoid call failures.'}, 'company_number': {'type': 'string', 'maxLength': 10, 'minLength': 1, 'description': "Companies House company number (8 digits, e.g. '03782379'). Returned by company_search."}, 'items_per_page': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Ignored — pagination is handled internally. Only accepted to avoid call failures.'}, 'include_resigned': {'type': 'boolean', 'default': False, 'description': 'Include resigned/historic officers. Default false for backwards-compatible current-officer queries.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['company_number', 'include_resigned', 'total'], 'properties': {'total': {'type': 'integer', 'description': 'Total officers returned (filtered by include_resigned).'}, 'officers': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Officer name as recorded at CH.'}, 'links': {'type': 'object', 'description': 'Upstream relational links (e.g. officer profile URL).', 'additionalProperties': True}, 'address': {'type': 'object', 'description': 'Officer correspondence address.', 'additionalProperties': True}, 'occupation': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Declared occupation.'}, 'officer_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Companies House officer ID, extracted from links.officer.appointments. Pass to officer_appointments to discover this person's full appointment history across companies, including dissolved or insolvent ones."}, 'nationality': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Declared nationality.'}, 'resigned_on': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Date of resignation if resigned, otherwise null.'}, 'appointed_on': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Date of appointment (ISO YYYY-MM-DD).'}, 'officer_role': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Officer role (e.g. 'director', 'secretary', 'llp-member')."}, 'date_of_birth': {'type': 'object', 'description': 'Partial date of birth (month/year) as returned by CH.', 'additionalProperties': True}, 'appointment_count': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Total number of other active appointments held by this officer, or null if unavailable. The Companies House officer list endpoint does not include this count; a separate per-officer call is required to populate it.'}, 'country_of_residence': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Declared country of residence.'}}, 'description': 'A single officer (director, secretary, etc.) of a company.'}, 'description': 'Officer records.'}, 'company_number': {'type': 'string', 'description': 'Companies House company number.'}, 'include_resigned': {'type': 'boolean', 'description': 'Whether resigned officers were included in this result.'}, 'high_appointment_count_flag': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Number of active officers with 10+ total appointments, or null if appointment counts were not fetched. Non-zero values are a nominee/phoenix director risk signal.'}}, 'description': 'List of officers for a given company.'}

{'type': 'object', 'required': ['company_number'], 'properties': {'company_number': {'type': 'string', 'maxLength': 10, 'minLength': 1, 'description': "Companies House company number (8 digits, e.g. '03782379'). Returned by company_search."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['company_number'], 'properties': {'accounts': {'type': 'object', 'properties': {'overdue': {'type': 'boolean', 'default': False, 'description': 'True if accounts are past their due date at Companies House.'}, 'next_due': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'ISO date the next set of accounts is due.'}, 'last_accounts_made_up_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'ISO date the most recent filed accounts were made up to.'}}, 'description': 'Accounts filing status and due dates.'}, 'sic_codes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Standard Industrial Classification codes.'}, 'has_charges': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}], 'default': None, 'description': "True if the company has at least one outstanding or part-satisfied charge (secured debt) — not yet fully discharged. False if every charge on record is fully satisfied, or there are none. Null if the charges check could not be completed, or if a charge was returned with an unrecognized status that can't be confidently classified. Use company_charges for the full charge-by-charge detail."}, 'company_name': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Registered company name.'}, 'company_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Companies House company type code.'}, 'company_number': {'type': 'string', 'description': 'Companies House company number.'}, 'company_status': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Current status (active, dissolved, in liquidation, etc.).'}, 'date_of_creation': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Incorporation date (ISO YYYY-MM-DD).'}, 'confirmation_statement': {'type': 'object', 'properties': {'overdue': {'type': 'boolean', 'default': False, 'description': 'True if the confirmation statement is past its due date.'}, 'next_due': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'ISO date the next confirmation statement is due.'}}, 'description': 'Confirmation statement filing status and next due date.'}, 'registered_office_address': {'type': 'object', 'description': 'Registered office address as returned by Companies House.', 'additionalProperties': True}}, 'description': 'Full Companies House profile for a single company number.'}

{'type': 'object', 'required': ['company_number'], 'properties': {'company_number': {'type': 'string', 'maxLength': 10, 'minLength': 1, 'description': "Companies House company number (8 digits, e.g. '03782379'). Returned by company_search."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['company_number', 'total'], 'properties': {'psc': {'type': 'array', 'items': {'type': 'object', 'properties': {'kind': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Upstream 'kind' (e.g. 'individual-person-with-significant-control', 'corporate-entity-person-with-significant-control')."}, 'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'PSC name (individual or entity).'}, 'address': {'type': 'object', 'description': 'PSC correspondence address.', 'additionalProperties': True}, 'ceased_on': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Date PSC status ceased, if applicable.'}, 'nationality': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Declared nationality for individual PSCs.'}, 'notified_on': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Date notified as a PSC (ISO YYYY-MM-DD).'}, 'date_of_birth': {'type': 'object', 'description': 'Partial date of birth (month/year) for individual PSCs as returned by CH.', 'additionalProperties': True}, 'identification': {'type': 'object', 'description': 'Identification block for corporate PSCs: place_registered, registration_number, country_registered, legal_authority, etc.', 'additionalProperties': True}, 'natures_of_control': {'type': 'array', 'items': {'type': 'string'}, 'description': "List of 'nature of control' descriptors (e.g. 'ownership-of-shares-75-to-100-percent'). Individual entries may be truncated to 300 characters each."}, 'country_of_residence': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Declared country of residence for individual PSCs.'}}, 'description': 'A single Person with Significant Control record.'}, 'description': 'Persons with Significant Control records.'}, 'note': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Explanatory note when total=0. Typical for widely-held listed PLCs where no single person or entity holds 25%+ of shares or voting rights.'}, 'total': {'type': 'integer', 'description': 'Total PSC entries returned for this company.'}, 'company_number': {'type': 'string', 'description': 'Companies House company number.'}, 'overseas_corporate_psc_flag': {'type': 'integer', 'default': 0, 'description': 'Number of corporate PSCs registered outside the UK. Non-zero values indicate an offshore beneficial ownership chain.'}}, 'description': 'List of Persons with Significant Control for a company.'}

{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'maxLength': 200, 'minLength': 2, 'description': 'Company name or keyword to search for'}, 'start_index': {'type': 'integer', 'default': 0, 'maximum': 10000, 'minimum': 0, 'description': 'Pagination offset. Default 0.'}, 'company_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Filter by company type (e.g. 'ltd', 'llp'). Omit to search all."}, 'company_status': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Filter by company status (e.g. 'active', 'dissolved'). Omit to search all."}, 'items_per_page': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Number of results to return (max 100). Default 20.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['query', 'total_results', 'start_index', 'items_per_page', 'returned', 'has_more'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Registered company name.'}, 'address': {'type': 'object', 'description': 'Registered office address as returned by the Companies House API.', 'additionalProperties': True}, 'sic_codes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Standard Industrial Classification codes associated with the company.'}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Short upstream description (usually number + status + creation date).'}, 'company_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Companies House company type code (e.g. 'ltd', 'plc', 'llp')."}, 'company_number': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Companies House company number (e.g. '12345678')."}, 'company_status': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Company status (e.g. 'active', 'dissolved', 'liquidation')."}, 'date_of_creation': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Incorporation date in ISO format (YYYY-MM-DD).'}}, 'description': 'A single entry in a Companies House search result.'}, 'description': 'Matching companies. Use the `company_number` field to call company_profile, company_officers, or company_psc for full detail.'}, 'query': {'type': 'string', 'description': 'The query string that was searched.'}, 'has_more': {'type': 'boolean', 'description': 'True if more results exist beyond this page. Re-call with start_index=start_index+items_per_page to fetch the next page.'}, 'returned': {'type': 'integer', 'description': 'Number of items actually returned on this page.'}, 'start_index': {'type': 'integer', 'description': 'Number of results skipped before this page (upstream start_index).'}, 'total_results': {'type': 'integer', 'description': 'Total matching companies in Companies House (server-side).'}, 'items_per_page': {'type': 'integer', 'description': 'Page size requested from the API for this call.'}}, 'description': 'Paginated result of a Companies House company search.'}

{'type': 'object', 'required': ['officer_id'], 'properties': {'officer_id': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Companies House officer ID. Returned by disqualified_search.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['officer_id', 'officer_kind'], 'properties': {'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Officer name.'}, 'surname': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Family name, if split upstream.'}, 'forename': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Given name, if split upstream.'}, 'officer_id': {'type': 'string', 'description': 'Companies House officer ID looked up.'}, 'nationality': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Declared nationality.'}, 'officer_kind': {'type': 'string', 'description': "Which CH endpoint returned the record: 'natural' (individual) or 'corporate' (legal entity)."}, 'date_of_birth': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Date of birth on record.'}, 'disqualifications': {'type': 'array', 'items': {'type': 'object', 'properties': {'reason': {'type': 'object', 'description': 'Reason block as returned upstream: act, section, description_identifier, article, etc.', 'additionalProperties': True}, 'address': {'type': 'object', 'description': 'Address on record at the time of the order.', 'additionalProperties': True}, 'heard_on': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Date the order was heard, when provided.'}, 'company_names': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Companies associated with this disqualification. The list may be truncated to 20 entries.'}, 'undertaken_on': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Date the undertaking was given, when provided.'}, 'last_variation': {'type': 'object', 'description': 'Details of the last variation of this order, if any.', 'additionalProperties': True}, 'case_identifier': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Upstream case_identifier, when provided.'}, 'disqualified_from': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Start date of the disqualification period.'}, 'disqualified_until': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'End date of the disqualification period.'}, 'company_names_total': {'type': 'integer', 'default': 0, 'description': 'Total number of companies originally attached to this order before truncation (may equal `len(company_names)`).'}, 'company_names_truncated': {'type': 'boolean', 'default': False, 'description': 'True if the company_names list was truncated to max_companies.'}}, 'description': 'A single disqualification order attached to a disqualified director.'}, 'description': 'All disqualification orders attached to this officer.'}}, 'description': 'Full disqualification record for a disqualified officer.'}

{'type': 'object', 'properties': {'name': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 2}, {'type': 'null'}], 'default': None, 'description': "Alias for query — the person's name."}, 'query': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 2}, {'type': 'null'}], 'default': None, 'description': "Person's name to search for, e.g. query='Richard Howson'. NOT a company name."}, 'start_index': {'type': 'integer', 'default': 0, 'maximum': 10000, 'minimum': 0, 'description': 'Pagination offset (0-based). Default 0.'}, 'items_per_page': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Results per page (max 100). Default 20.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['query', 'total_results', 'start_index', 'items_per_page', 'returned', 'has_more'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'links': {'type': 'object', 'description': 'Upstream relational links (self, etc.).', 'additionalProperties': True}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Display title (typically the officer's name)."}, 'address': {'type': 'object', 'description': 'Last known address of the disqualified officer.', 'additionalProperties': True}, 'snippet': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Upstream match snippet highlighting query terms.'}, 'officer_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Companies House officer ID extracted from the self link. Pass to disqualified_profile for the full disqualification record.'}, 'date_of_birth': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Date of birth as returned by the search API.'}}, 'description': 'A single hit in a disqualified officers search.'}, 'description': 'Matching disqualified officer records.'}, 'query': {'type': 'string', 'description': 'Search query applied.'}, 'has_more': {'type': 'boolean', 'description': 'True if more items may exist beyond this page. Re-call with start_index=start_index+items_per_page to continue.'}, 'returned': {'type': 'integer', 'description': 'Items actually returned on this page.'}, 'start_index': {'type': 'integer', 'description': 'Pagination offset for this page.'}, 'total_results': {'type': 'integer', 'description': 'Total matching records upstream at Companies House.'}, 'items_per_page': {'type': 'integer', 'description': 'Page size requested.'}}, 'description': 'Paginated disqualified officers search result.'}

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 100, 'minLength': 3, 'description': 'Prefixed record ID returned by search. Format: company:{number}, charity:{number}, disqualification:{officer_id}, or notice:{notice_id}'}}, 'additionalProperties': False}

{'type': 'object', 'additionalProperties': True}

{'type': 'object', 'properties': {'name': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 2}, {'type': 'null'}], 'default': None, 'description': 'Company or individual name to search for in Gazette insolvency notices'}, 'query': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 2}, {'type': 'null'}], 'default': None, 'description': 'Alias for name.'}, 'end_date': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Filter notices up to this date (YYYY-MM-DD)'}, 'start_date': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Filter notices from this date (YYYY-MM-DD)'}, 'entity_name': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 2}, {'type': 'null'}], 'default': None, 'description': 'Deprecated alias for name.'}, 'max_notices': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Cap on notices returned, applied after severity/date sort. Default 20. The Gazette insolvency feed returns up to 100 results per search — raise to 100 to see the full set.'}, 'notice_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Filter by Gazette notice code (e.g. '2450' petition to wind up a company, '2452' winding-up order, '2410' appointment of administrators). Omit to search all."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['entity_name', 'total_notices', 'max_notices_cap'], 'properties': {'notices': {'type': 'array', 'items': {'type': 'object', 'properties': {'date': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Publication date (ISO YYYY-MM-DD).'}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Notice title.'}, 'content': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Brief notice excerpt from the search feed (HTML stripped). For full legal wording read notice://{notice_numeric_id}.'}, 'severity': {'type': 'integer', 'default': 0, 'description': 'Internal severity score 0-10. Higher = more serious (10 = winding-up order, 9 = administration/receiver/liquidator appointment, 0 = informational or unclassified).'}, 'notice_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Gazette notice URI (e.g. 'https://www.thegazette.co.uk/id/notice/5122793')."}, 'notice_code': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Gazette notice code (e.g. '2450' petition to wind up a company, '2452' winding-up order for a company)."}, 'notice_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Human-readable notice type label (e.g. 'Winding-Up Order')."}, 'notice_numeric_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Numeric notice ID. Read full notice content via the notice://{notice_numeric_id} resource.'}}, 'description': 'A single corporate insolvency notice from The Gazette.'}, 'description': 'Matching notices, sorted by severity (desc) then date (desc).'}, 'end_date': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Upper bound of the date range filter, if any.'}, 'start_date': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Lower bound of the date range filter, if any.'}, 'entity_name': {'type': 'string', 'description': 'Entity name that was searched.'}, 'total_notices': {'type': 'integer', 'description': 'Total notices returned after deduplication, sorting, and cap.'}, 'max_notices_cap': {'type': 'integer', 'description': 'The max_notices cap applied. Upstream may have more matching notices.'}, 'notice_type_filter': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Notice code filter applied, or null if all codes searched.'}}, 'description': 'Aggregated Gazette insolvency notice search result.'}

{'type': 'object', 'required': ['notice_id'], 'properties': {'notice_id': {'type': 'string', 'maxLength': 20, 'minLength': 1, 'description': 'Numeric Gazette notice ID. Returned as notice_numeric_id by gazette_insolvency.'}}, 'additionalProperties': False}

{'type': 'object', 'additionalProperties': True}

{'type': 'object', 'required': ['address_or_postcode'], 'properties': {'address_or_postcode': {'type': 'string', 'maxLength': 200, 'minLength': 4, 'description': "UK property address or postcode. Postcode is most reliable: e.g. 'NG1 1AB'. Full address also accepted."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['postcode', 'total'], 'properties': {'total': {'type': 'integer', 'description': 'Number of Price Paid transactions returned. Capped at 10 by the upstream SPARQL query.'}, 'postcode': {'type': 'string', 'description': 'Normalised UK postcode extracted from the input.'}, 'transactions': {'type': 'array', 'items': {'type': 'object', 'properties': {'paon': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Primary addressable object name (house number or name).'}, 'saon': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Secondary addressable object name (flat/unit identifier).'}, 'town': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Town/city.'}, 'county': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'County.'}, 'street': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Street name.'}, 'postcode': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Property postcode.'}, 'price_paid': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Sale price in GBP (integer pounds).'}, 'estate_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Tenure / estate type label (e.g. 'Freehold', 'Leasehold')."}, 'property_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Property type label extracted from the HMLR URI (e.g. 'Terraced', 'Semi Detached', 'Flat')."}, 'transaction_date': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Transaction date (ISO YYYY-MM-DD).'}}, 'description': 'A single Price Paid transaction for a property.'}, 'description': 'Recent Price Paid transactions for the postcode, sorted newest first.'}}, 'description': 'HMLR Price Paid Index search result for a given postcode.'}

{'type': 'object', 'required': ['officer_id'], 'properties': {'officer_id': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Companies House officer ID. Returned as officer_id on entries from company_officers.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['officer_id', 'total'], 'properties': {'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Officer name as recorded at CH.'}, 'total': {'type': 'integer', 'description': 'Total appointments returned.'}, 'officer_id': {'type': 'string', 'description': 'Companies House officer ID.'}, 'active_count': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': "Upstream count of appointments Companies House categorizes as 'active' — this reflects the officer's own appointment/resignation state at that company, NOT whether the company itself is currently trading. An appointment at a company in liquidation or administration still counts as active here if the officer was never formally resigned. Check each appointment's own company_status field for the company's actual status. Null if not provided upstream."}, 'appointments': {'type': 'array', 'items': {'type': 'object', 'properties': {'links': {'type': 'object', 'description': "Upstream relational links, e.g. links.company = '/company/{number}'.", 'additionalProperties': True}, 'address': {'type': 'object', 'description': 'Officer correspondence address for this appointment.', 'additionalProperties': True}, 'nationality': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Declared nationality.'}, 'resigned_on': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Date of resignation, or null if not resigned.'}, 'appointed_on': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Date of appointment (ISO YYYY-MM-DD).'}, 'company_name': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Company name as recorded at CH for this appointment.'}, 'officer_role': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Officer role at this company (e.g. 'director', 'secretary')."}, 'company_number': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Companies House company number for this appointment.'}, 'company_status': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Company status at the time of lookup (e.g. 'active', 'liquidation', 'dissolved'), as returned upstream. Companies House does not auto-resign directors on insolvency, so resigned_on may be null even when company_status shows the company is no longer trading — check company_status, not just resigned_on, to assess a relationship."}, 'country_of_residence': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Declared country of residence.'}}, 'description': "A single appointment from an officer's full appointment history."}, 'description': 'Every appointment, current and historic.'}, 'date_of_birth': {'type': 'object', 'description': 'Partial date of birth (month/year), or empty if not disclosed upstream.', 'additionalProperties': True}, 'inactive_count': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': "Upstream count of appointments Companies House categorizes as 'inactive', passed through as-is. Exact categorization semantics have not been independently verified against per-appointment data — treat as an unverified upstream fact, not a derived signal, or null if not provided."}, 'resigned_count': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Upstream count of resigned appointments, or null if not provided.'}}, 'description': "A person's full appointment history across companies, by officer ID."}

{'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 2, 'description': 'Person or company/entity name to screen against the consolidated sanctions lists.'}, 'entity_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Optional filter: 'person' or 'entity'. Omit to screen both."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['query', 'normalized_query', 'match_count'], 'properties': {'hits': {'type': 'array', 'items': {'type': 'object', 'required': ['list_source', 'matched_name'], 'properties': {'regime': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Sanctions programme/regime the listing falls under (e.g. 'Russia', 'CUBA', 'DRC')."}, 'is_alias': {'type': 'boolean', 'default': False, 'description': 'True if the match was on an alias/AKA rather than the primary listed name.'}, 'listed_on': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Date the entity was listed, where the source provides it (ISO YYYY-MM-DD).'}, 'reference': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "The source's own reference for the listing (OFSI Group ID, OFAC uid, EU reference number, or UN reference number)."}, 'entity_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "'person' or 'entity' where the source distinguishes it; otherwise null."}, 'list_source': {'type': 'string', 'description': "Which consolidated list matched: 'OFSI (UK)', 'OFAC (US)', 'EU', or 'UN'."}, 'matched_name': {'type': 'string', 'description': 'The exact name or alias on the list that matched the query.'}}, 'description': 'A single sanctions-list entry matching a screened name.'}, 'description': 'Matching list entries. An empty list means no exact/alias match on the screened lists — NOT a guarantee of clearance (see the tool description on matching limits).'}, 'as_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'When this server last refreshed the loaded lists (ISO timestamp). Provenance for the screen — the lists update on designation.'}, 'query': {'type': 'string', 'description': 'The name that was screened.'}, 'match_count': {'type': 'integer', 'description': 'Number of list entries that matched the query.'}, 'lists_screened': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Which consolidated lists were loaded and actually screened for this call. A list absent here failed to load and was NOT screened — treat the result as partial if any of OFSI/OFAC/EU/UN is missing.'}, 'normalized_query': {'type': 'string', 'description': 'The normalised form used for matching (upper-cased, accent- and punctuation-stripped, whitespace-collapsed).'}, 'entity_type_filter': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "entity_type filter applied to the screen ('person'/'entity'), or null."}}, 'description': 'Result of screening one name against the consolidated sanctions lists.'}

{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'maxLength': 200, 'minLength': 2, 'description': 'Company name, charity name, director name, or keyword to search for across all UK due diligence registers'}}, 'additionalProperties': False}

{'type': 'object', 'additionalProperties': True}