{"tool":"counterparty-check","mcp_name":"counterparty_check","title":"Counterparty Check API: KYB checklist from official registers","description":"KYB checklist per company: register status, LEI, insolvency, recent accounts, sanctions (OFAC, UN, UK, EU) on the company and officers, VAT (VIES), IBAN; pass, fail, review or unverified, each sourced. Officers: UK, PL, NO, FR only. Insolvency: UK, PL, FR, DE, NL, NO, FI, EE; elsewhere unverified.","endpoint":"https://api.boscolabs.dev/v1/counterparty-check","event":"counterparty-check","price_usd_per_row":0.05,"caps":{"companies":10},"input_schema":{"type":"object","properties":{"query":{"title":"Company (name or identifier)","type":"string","description":"The counterparty to check: a name (e.g. \"Novo Nordisk\") or an identifier: LEI (20 characters, e.g. \"724500Y6DUVHQD6OXN27\"), UK company number (\"00445790\", \"SC123456\"), Danish CVR (\"24256790\"), Norwegian org number (\"923609016\"), French SIREN (9 digits, \"552032534\") or SIRET (14 digits, \"55203253400703\"), Finnish Business ID with its dash (\"0112038-9\"), Estonian registry code (8 digits, \"12417834\"), US ticker in capitals or with $ (\"AAPL\", \"$brk.b\"; foreign companies listed in the US resolve to their home country), SEC CIK (\"320193\"). The type is detected from format and check digits; an 8-digit number valid in several registers (UK, Danish CVR, Estonian) is settled by asking them, and `country` decides when given. Required, unless you give a `companies` list instead.","pattern":"^[^\\[\\]{}<>\\r\\n]*$"},"country":{"title":"Country (optional)","type":"string","description":"ISO 3166 alpha-2 country code to disambiguate, e.g. \"DK\", \"GB\", \"NO\", \"FR\", \"FI\", \"EE\", \"NL\", \"US\". With a name it limits the search to that country and, for NO, FR, FI and EE, also searches the national register (most companies there have no LEI); with a number it says which register the number belongs to (e.g. \"GB\" for a UK number without a leading zero, \"EE\" for an Estonian registry code, \"FI\" for a Business ID typed without its dash). Empty = detect from the query.","pattern":"^\\s*([A-Za-z]{2})?\\s*$"},"vatNumber":{"title":"EU VAT number (optional)","type":"string","description":"The VAT number the counterparty gave you, with its country prefix, e.g. \"DK24256790\". Checked live in VIES (valid or not, registered name) and matched against the register's name and country. Empty = the VAT number the register lists, if any (Estonia, Poland); otherwise the VAT check is unverified.","pattern":"^[^\\[\\]{}<>\r\n]*$"},"iban":{"title":"IBAN (optional)","type":"string","description":"The bank account the counterparty wants to be paid on, e.g. \"DK5000400440116243\". Checked offline: length, layout and ISO 13616 check digits, bank code, and whether its country matches the company's. No bank is contacted, so it does not prove who holds the account.","pattern":"^[^\\[\\]{}<>\r\n]*$"},"walletAddresses":{"title":"Crypto wallet addresses (optional)","type":"array","description":"Wallet addresses the counterparty wants to be paid on, e.g. [\"0x7FF9cFad3877F21d41Da833E2F775dB0569eE3D9\"]. Each is matched exactly against the addresses OFAC lists. At most 10.","maxItems":10,"items":{"type":"string","pattern":"^\\s*\\S{1,128}\\s*$"}},"companies":{"title":"Companies (batch, optional)","type":"array","description":"Check a list of companies in one run instead of `query`: up to 10 companies, each a name or number (\"Tesco PLC\") or an object with the fields above, e.g. [\"Tesco PLC\", {\"query\": \"Novo Nordisk A/S\", \"country\": \"DK\", \"vatNumber\": \"DK24256790\"}, {\"query\": \"00445790\", \"country\": \"GB\"}]. One row per company, priced like a single check ($0.05 per company checked); an ambiguous name, or a company no source knows or that does not answer in time, is a row that costs nothing. Leave `query` empty when you use this.","maxItems":10,"items":{"anyOf":[{"type":"string"},{"type":"object","properties":{"query":{"type":"string","description":"Name, LEI or registration number, as in `query`, e.g. \"24256790\"."},"country":{"type":"string","description":"ISO 3166 alpha-2 code, e.g. \"DK\"."},"vatNumber":{"type":"string","description":"As in `vatNumber`, e.g. \"DK24256790\"."},"iban":{"type":"string","description":"As in `iban`, e.g. \"DK5000400440116243\"."}},"required":["query"]}]}}},"required":[]},"example_input":{"query":"24256790","country":"DK","vatNumber":"DK24256790"},"example_rows":[{"schema_version":"1","query":"24256790","status":"checked","company":{"legal_name":"NOVO NORDISK A/S","country":"DK","registration_number":"24256790","register":"Erhvervsstyrelsen (CVR)","lei":"549300DAQ1CVT6CXN342","lei_status":"ISSUED","status":"active","legal_form":"Aktieselskab","registered_address":"Novo Alle 1, 2880 Bagsværd, DK"},"checks":[{"check":"register_status","status":"pass","detail":"Register status: active.","source":"GLEIF","source_url":"https://api.gleif.org/api/v1/lei-records/549300DAQ1CVT6CXN342","checked_at":"2026-11-08T04:12:24+00:00"},{"check":"lei_status","status":"pass","detail":"LEI 549300DAQ1CVT6CXN342 is ISSUED.","source":"GLEIF","source_url":"https://search.gleif.org/#/record/549300DAQ1CVT6CXN342","checked_at":"2026-11-08T04:12:24+00:00"},{"check":"insolvency","status":"unverified","detail":"Insolvency covers the UK, Poland, France, Germany and the Netherlands (insolvency registers) and Norway, Finland and Estonia (register status).","source":null,"source_url":null,"checked_at":"2026-11-08T04:12:24+00:00"},{"check":"accounts_recent","status":"pass","detail":"Newest annual accounts: year ending 2025-12-31 (11 months ago).","source":"filings.xbrl.org","source_url":"https://filings.xbrl.org/549300DAQ1CVT6CXN342/2025-12-31/ESEF/DK/0/NOVO-2025-12-31-1-en.json","checked_at":"2026-11-08T04:12:24+00:00"},{"check":"sanctions_entity","status":"pass","detail":"No match. Checked: OFAC Consolidated (non-SDN) List 2026-11-04, UN Security Council Consolidated List 2026-11-08, UK Sanctions List 2026-11-03, EU Consolidated Financial Sanctions List 2026-10-23, US Consolidated Screening List (Commerce, State) 2026-11-08, OFAC SDN List 2026-11-06.","source":"OFAC, UN, UK, EU and US export lists","source_url":null,"checked_at":"2026-11-08T04:12:24+00:00"},{"check":"sanctions_people","status":"unverified","detail":"No officer or owner names known (UK and Polish registers list them; Polish names are masked).","source":null,"source_url":null,"checked_at":"2026-11-08T04:12:24+00:00"},{"check":"vat_number","status":"unverified","detail":"VIES is not answering (SERVICE_UNAVAILABLE); try again later","source":"VIES (European Commission), answered by the national tax administration","source_url":"https://ec.europa.eu/taxation_customs/vies/#/vat-validation","checked_at":"2026-11-08T04:12:24+00:00"},{"check":"iban","status":"pass","detail":"DK5000400440116243: structure and check digits valid. Bank code 0040; no bank was contacted.","source":"ISO 13616 check digits (mod 97) and the SWIFT IBAN Registry formats","source_url":"https://www.swift.com/standards/data-standards/iban-international-bank-account-number","checked_at":"2026-11-08T04:12:24+00:00"},{"check":"iban_country_match","status":"pass","detail":"expected DK, number is DK","source":"ISO 13616 check digits (mod 97) and the SWIFT IBAN Registry formats","source_url":"https://www.swift.com/standards/data-standards/iban-international-bank-account-number","checked_at":"2026-11-08T04:12:24+00:00"}],"summary":{"pass":6,"fail":0,"review":0,"unverified":3,"needs_attention":[],"unverified_checks":["insolvency","sanctions_people","vat_number"]},"notice":"Screening aid built from official sources, not a compliance, credit or legal determination. 'unverified' means not checked, never 'safe'. Review every 'fail' and 'review' against the linked source before acting.","latest_financials":{"basis":"Consolidated annual report of a listed company (ESEF, IFRS figures).","source":"filings.xbrl.org","period_end":"2025-12-31","currency":"DKK","revenue":309064000000,"net_income":102434000000,"total_assets":542902000000,"source_url":"https://filings.xbrl.org/549300DAQ1CVT6CXN342/2025-12-31/ESEF/DK/0/NOVO-2025-12-31-1-en.json"},"sanctions":{"entity":{"query":"NOVO NORDISK A/S","match_found":false,"best_score":null,"complete":true,"summary":"No match >= 85 for 'NOVO NORDISK A/S'. Checked: OFAC Consolidated (non-SDN) List 2026-11-04, UN Security Council Consolidated List 2026-11-08, UK Sanctions List 2026-11-03, EU Consolidated Financial Sanctions List 2026-10-23, US Consolidated Screening List (Commerce, State) 2026-11-08, OFAC SDN List 2026-11-06."},"people_with_matches":[],"people_screened":0},"vat":{"number":"DK24256790","status":"unverified","valid":null,"registered_name":null,"name_match":null,"country_match":null,"source_url":"https://ec.europa.eu/taxation_customs/vies/#/vat-validation"},"iban":{"number":"DK5000400440116243","status":"pass","valid":true,"bank_code":"0040","country_match":true,"source":"ISO 13616 check digits (mod 97) and the SWIFT IBAN Registry formats"},"wallets":[],"warnings":["EU Consolidated Financial Sanctions List: download failed (HTTP 500); used the copy fetched 2026-11-07T01:57 UTC (list dated 2026-10-23)."],"source_url":"https://api.gleif.org/api/v1/lei-records/549300DAQ1CVT6CXN342","retrieved_at":"2026-11-08T04:12:24+00:00","duration_seconds":28.5}],"output_fields":["query","status","company","checks","summary","notice","latest_financials","people","insolvency","us_listing","sanctions","vat","iban","wallets","candidates","warnings","source_url","retrieved_at"],"sources":["GLEIF LEI data (CC0); no endorsement by GLEIF implied.","SEC EDGAR (US public data) and FDIC BankFind.","filings.xbrl.org (ESEF annual reports).","Brønnøysundregistrene (NLOD); Erhvervsstyrelsen (CVR); Companies House.","The Gazette insolvency notices, Open Government Licence v3.0.","Sirene (INSEE) via recherche-entreprises.api.gouv.fr, Licence Ouverte 2.0.","PRH Trade Register (YTJ), CC BY 4.0; e-Business Register (RIK), CC BY 4.0.","Polish National Court Register (KRS) open API, public domain; VAT white list (MF).","OFAC SDN and Consolidated lists (US Treasury): US government works; no endorsement by OFAC implied.","This product uses the International Trade Administration's Data API but is not endorsed or certified by the International Trade Administration.","UK Sanctions List (FCDO): contains public sector information licensed under the Open Government Licence v3.0.","EU Consolidated Financial Sanctions List (European Commission, reuse under Decision 2011/833/EU); only the Official Journal of the EU is authentic.","VIES (European Commission): answers come from the member states' VAT databases; the Commission accepts no responsibility for them. Not legal or tax advice.","IBAN formats: SWIFT ISO 13616 IBAN Registry (royalty-free licence to use the published information); check digits per ISO 13616 (mod 97). No bank is contacted.","Screening aid, not a compliance, credit or legal determination: review every 'fail' and 'review' before acting."]}