{"uid":"cap_AGUg9Q59g3xgaSLxIOghM","slug":"counterparty-check-kyb-facts-70ded425","name":"Counterparty Check (KYB Facts)","description":"Counterparty check (KYB preflight) in one call: give any of a company name, domain, LEI or crypto wallet address (plus an optional EU VAT number), get neutral sourced facts for vendor onboarding and supplier due diligence: sanctions screen of the name on OFAC, EU and UK lists with UN designations flagged, OFAC wallet check, GLEIF LEI match and status, domain age, registrar and email-auth, and an EU VAT number format check. No risk score or verdict. Signed receipt.","url":"https://api.stablecoingateways.com/v1/counterparty-check?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","properties":{"lei":{"type":"string","pattern":"^[A-Za-z0-9]{18}[0-9]{2}$","description":"20-character LEI (instead of a GLEIF name search)"},"uei":{"type":"string","pattern":"^[A-Za-z0-9]{12}$","description":"12-character SAM.gov Unique Entity ID: exact match in the SAM.gov exclusions extract (name= is also matched there)"},"vat":{"type":"string","examples":["DE129274202"],"maxLength":24,"description":"EU VAT number with 2-letter country prefix (EL for Greece, XI for Northern Ireland); format check only, not a VIES registration check"},"name":{"type":"string","examples":["Siemens Aktiengesellschaft"],"maxLength":120,"minLength":2,"description":"Company legal or trading name: screened on OFAC, EU and UK sanctions lists and SAM.gov exclusions (entities only) and matched in GLEIF"},"domain":{"type":"string","pattern":"^[A-Za-z0-9.-]{3,253}$","examples":["siemens.com"],"description":"Company domain: registration age, registrar, DNS and email-auth facts"},"address":{"type":"string","maxLength":120,"minLength":20,"description":"Crypto wallet address to check against OFAC-listed addresses"},"country":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"ISO 3166 alpha-2 country filter for LEI matches"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data","receipt"],"properties":{"data":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"lei":{"type":"object","properties":{"query":{"type":"string"},"checked":{"type":"boolean"},"records":{"type":"array","items":{"type":"object"}},"total_matches":{"type":"integer"},"country_filter":{}}},"vat":{"type":"object","properties":{"note":{"type":"string"},"checked":{"type":"boolean"},"country":{"type":"string"},"verify_at":{"type":"string"},"country_code":{"type":"string"},"format_valid":{"type":"boolean"},"input_normalised":{"type":"string"},"registration_checked":{"type":"boolean"}}},"facts":{"type":"array","items":{"type":"object"}},"query":{"type":"object","properties":{"lei":{},"uei":{},"vat":{"type":"string"},"name":{"type":"string"},"domain":{"type":"string"},"address":{},"country":{}}},"domain":{"type":"object","properties":{"dns":{"type":"object"},"https":{"type":"object"},"domain":{"type":"string"},"exists":{"type":"boolean"},"checked":{"type":"boolean"},"expires":{"type":"string"},"age_years":{"type":"number"},"mail_auth":{"type":"object"},"registrar":{"type":"string"},"registered":{"type":"string"},"rdap_available":{"type":"boolean"},"registry_status":{"type":"array","items":{"type":"string"}}}},"notice":{"type":"string"},"wallet":{"type":"object","properties":{"reason":{"type":"string"},"screened":{"type":"boolean"}}},"sources":{"type":"array","items":{"type":"string"}},"sanctions":{"type":"object","properties":{"lists":{"type":"array","items":{"type":"object"}},"query":{"type":"string"},"scope":{"type":"string"},"matches":{"type":"array","items":{}},"screened":{"type":"boolean"},"min_score":{"type":"number"},"confirm_at":{"type":"array","items":{"type":"string"}},"match_count":{"type":"integer"},"match_counts":{"type":"object"},"lists_screened":{"type":"array","items":{"type":"string"}}}},"checked_at":{"type":"string"},"name_links":{"type":"string"},"provenance":{"type":"object","description":"Additive evidence block (sg-provenance/1): per-fact source, retrieval time, limits; no score or verdict. Full schema in OpenAPI."},"us_exclusions":{"type":"object","properties":{"list":{"type":"string"},"note":{"type":"string"},"query":{"type":"object"},"scope":{"type":"string"},"method":{"type":"string"},"source":{"type":"string"},"checked":{"type":"boolean"},"extract":{"type":"object"},"matches":{"type":"array","items":{}},"verify_at":{"type":"string"},"match_count":{"type":"integer"},"dnb_attribution":{"type":"string"}}}},"description":"Sourced facts[] plus sanctions, us_exclusions (SAM.gov), wallet, lei, domain and vat sections; each section says whether it was checked and why not"},"receipt":{"type":"object","required":["v","endpoint_id","ts","price","tx_hash","request_hash","response_hash","log_seq","sig"],"properties":{"evidence":{"type":"object","description":"Signed evidence (see llms.txt)"}},"description":"Ed25519-signed receipt; verify free at POST /v1/verify-receipt. New receipts also carry a signed `evidence` object."}}}}}}},"responseSchema":{"type":"json","example":{"data":{"lei":{"query":"Siemens Aktiengesellschaft","checked":true,"records":[{}],"total_matches":2,"country_filter":null},"vat":{"checked":true,"country":"Germany","country_code":"DE","format_valid":true,"input_normalised":"DE129274202"},"facts":[{"fact":"No entity on the SDN, CONS, EU, UK, UN lists matched \"Siemens Aktiengesellschaft\" at sc...","source":"OFAC SLS (US Treasury), EU Financial Sanctions Files (European Commission), UK Sanction..."}],"query":{"lei":null,"vat":"DE129274202","name":"Siemens Aktiengesellschaft","domain":"siemens.com","country":null},"domain":{"domain":"siemens.com","exists":true,"checked":true,"age_years":40.1,"registered":"1986-09-29"},"notice":"Neutral facts with sources. Not a risk score, KYB verdict or compliance determination. ...","wallet":{"reason":"no address given","screened":false},"sources":["OFAC Sanctions List Service (US Treasury)"],"sanctions":{"query":"Siemens Aktiengesellschaft","screened":true,"min_score":0.85,"match_count":0,"lists_screened":["SDN"]},"checked_at":"2026-10-22T23:02:47.799Z","name_links":"Not verified: this check does not prove that the name, domain, LEI, VAT number and addr...","us_exclusions":{"reason":"SAM.gov exclusions are not included: the SAM.gov API requires a key from a registered S...","checked":false,"verify_at":"https://sam.gov/search/?index=ex"}},"receipt":{"v":1,"ts":"2026-10-22T09:00:00Z","sig":"hex","price":{"asset":"USDC","amount":"10000","network":"eip155:84532"},"log_seq":1,"tx_hash":"0x..","endpoint_id":"counterparty-check-v1","request_hash":"hex","response_hash":"hex"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2Ar7486ssfjZolPIcV0jP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs a sanctions screen, LEI lookup, domain analysis, and OFAC wallet check on a company name, domain, LEI, or crypto wallet address — returning neutral sourced facts for vendor onboarding and supplier due diligence.","exampleAgentPrompt":"Before we onboard Siemens Aktiengesellschaft as a supplier, can you run a counterparty check on them — screen the company name against OFAC, EU, and UK sanctions lists, look up their LEI in GLEIF, check the siemens.com domain age and email auth, and validate their EU VAT number DE129274202?","exampleUseCases":[{"title":"New supplier sanctions screening","prompt":"We're about to pay a new vendor called Acme Trading GmbH — can you screen them against OFAC, EU, and UK sanctions lists, pull their GLEIF LEI record, and check if acmetrading.de is a real established domain before we wire money?"},{"title":"Crypto wallet OFAC check before payment","prompt":"Before I send USDC to this wallet address 0x3f5CE5FBFe3E9af3971dD833D26bA9b5C936f0bE, can you check whether it's on the OFAC sanctions list?"},{"title":"Vendor VAT and domain verification","prompt":"We received an invoice from a company claiming to be registered as DE129274202 with domain globalparts-eu.com — can you validate the VAT format, check the domain age, and screen the name Global Parts EU GmbH on sanctions lists?"}],"resultDescription":"Returns a structured JSON object with: sanctions screening results (OFAC SDN, EU, UK, UN lists) with match count and minimum score threshold; GLEIF LEI lookup records and total matches; domain facts including age in years, registration date, registrar, DNS and email-auth details; EU VAT number format validation with country; OFAC crypto wallet screening status; a list of sourced neutral facts about the counterparty; a notice clarifying no risk score or verdict is provided; and a signed cryptographic receipt including timestamp, transaction hash, price, and request/response hashes.","failureModes":["Missing required input: no name, domain, LEI, or address provided — returns error","Invalid LEI format (must be 18 alphanumeric + 2 digit check characters) — returns validation error","Invalid domain format — returns validation error","SAM.gov exclusions not checked if no API key configured — returns partial result with explanation","GLEIF API unavailable — LEI field may return unchecked status","OFAC Sanctions List Service unreachable — sanctions field may return error or unchecked status","Invalid country code (not ISO 3166 alpha-2) — returns validation error","Payment not received or insufficient — returns 402 Payment Required"],"whenToPreferThis":"Choose this endpoint when you need a single-call KYB preflight that combines sanctions screening (OFAC, EU, UK, UN), GLEIF LEI verification, domain intelligence, and OFAC crypto wallet checks in one response with a signed receipt. Prefer it over individual point solutions when onboarding vendors, verifying counterparties before payments, or building automated supplier due diligence workflows. It is particularly valuable when you need sourced neutral facts rather than a risk score, and when working in regulated environments that require audit trails via cryptographic receipts. Use the dedicated LEI Lookup or Crypto Wallet Sanctions endpoints if you only need one of those checks individually.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T07:05:14.267Z","isFirstParty":false,"canonicalSlug":"counterparty-check-kyb-facts-70ded425"}