# Factline

> Official-records checks for AI agents: European companies, sanctions, PEP and VAT in one call, with the source to quote. Plus Dutch addresses, neighbourhoods and vehicles from government open data, in English. Pay per call with x402 (USDC on Base or Solana) or use an API key; failed calls are not charged.

No wallet? Free trial key (2,000 credits a month): POST https://factline.dev/v1/key/trial with {"email": "you@company.com"}, or the MCP tool get_trial_key. The first 5 paid calls a day are free, over MCP and as plain GET requests, no wallet or key needed (header X-Factline-Free-Call shows the count).

Start here for compliance and onboarding: the European company check (/v1/kyb/check, MCP tool eu_company_check) and the KYC check (/v1/kyc/check). Landing page: https://factline.dev/kyb. MCP: https://factline.dev/mcp/kyc. Setup for every client: https://factline.dev/agents.

Agent skills (SKILL.md) that make an agent run these checks every time: verify a supplier invoice before paying, check a new counterparty, guard an x402 payment, check a Chinese supplier (UFLPA, Entity List), Dutch address and vehicle facts. Install: `npx skills add factline-dev/factline-skills`, or in Claude Code `/plugin marketplace add factline-dev/factline-skills`. List: https://factline.dev/skills.json

## Companies and people (any country)
- [Self-hosted wallet evidence](https://factline.dev/v1/wallet/evidence?wallet=0x0330070fd38ec3bb94f58fa55d40368271e9e54a&owner=Jan%20de%20Vries): $0.02 USDC. For crypto firms: wallet vs OFAC, claimed owner vs EU/UN/UK/US sanctions and PEP, company record; one dated record with a signed receipt.
- [Watch for 30 days](https://factline.dev/v1/watch/new?kind=company&value=IE:Ryanair): $0.05 USDC once. Alerts when a name gets a sanctions match, a company's register status, name or address changes, or a Dutch plate's APK or recalls change; webhook or polling with the returned token.
- Portfolio re-screening (API key): POST https://factline.dev/v1/watch/bulk with up to 1,000 names or companies (JSON items or CSV, one per line). Every name is re-screened against the EU, UN, UK and US lists whenever they change, companies daily; alerts by webhook or GET /v1/watch/alerts, overview at GET /v1/watch/summary. Credits per item per run (sanctions 3, company 4).
- [Bulk screening](https://factline.dev/v1/screen/bulk?names=Vladimir%20Putin;Factline;Jan%20de%20Vries): metered, $0.0012 per name per list (x402 upto, cap $0.24). Up to 100 names against EU, UN, UK and US sanctions and PEP.
- [ECB exchange rates, free](https://factline.dev/v1/eu/fx?symbols=USD,GBP): official euro reference rates, today or a date in the last 90 days, cross rates and amounts.
- [EU law lookup, free](https://factline.dev/v1/eu/law?q=Regulation%20(EU)%202016/679): title, date, in force or not, EUR-Lex link, by CELEX or citation.
- [Payee check](https://factline.dev/v1/payee/check?url=https%3A%2F%2Ffactline.dev%2Fv1%2Fkyb%2Fcheck): $0.01 USDC. Before paying an x402 seller: its payTo wallets against OFAC, domain age, uptime, optional company check; allow, review or deny. Free list of x402 sellers with uptime: https://factline.dev/v1/x402/sellers.
- [Pay guard](https://factline.dev/v1/pay/guard?url=https%3A%2F%2Ffactline.dev%2Fv1%2Fkyb%2Fcheck&pay_to=0xb58dd178abac67f6d4894437a7fc725cbddb2075&amount_usd=0.05): free. The check an x402 client runs right before paying: payTo wallet against OFAC and against the wallets the seller lists in the Bazaar and Circle catalogues (catches a swapped payTo), seller payer history, age and uptime, amount against the seller's listed price and your budget; allow, review or deny in one fast call with a signed verdict. Add mode=strict to deny instead of review. Client plugin: https://factline.dev/agents#pay-guard.
- [Chinese supplier check](https://factline.dev/v1/china/supplier-check?name=Huawei%20Technologies&uscc=914403001922038216): $0.03 USDC. Validates the Unified Social Credit Code (checksum, province; Xinjiang flagged) and screens the supplier against EU, UN, UK and US sanctions, the BIS Entity List and the UFLPA Entity List; one verdict.
- [US trade screening](https://factline.dev/v1/trade/screen?name=Hoshine%20Silicon%20Industry): $0.005 USDC. BIS Entity List, Military End User, Unverified, Denied Persons, ITAR debarred, Treasury non-SDN lists and the DHS UFLPA Entity List. Also on the sanctions screen with include=trade.
- [US company lookup](https://factline.dev/v1/us/company?ticker=AAPL): $0.01 USDC. SEC EDGAR record of a US listed company: legal name, tickers, EIN, state of incorporation, industry, latest 10-K and 10-Q.
- [Exchange rates](https://factline.dev/v1/fx/rate?base=USD&symbols=EUR,GBP&amount=100): $0.001 USDC. ECB official reference rates, about 30 currencies, cross rates and conversion, today or an invoice date in the last 90 days.
- [Company dossier](https://factline.dev/v1/company/dossier?name=Equinor&country=NO): $0.15 USDC. Due diligence in one answer: the full company check plus financial health (size, turnover and result where published, accounts on time, insolvency), one verdict and a cite_as line.
- [Company financial health](https://factline.dev/v1/company/health?id=552032534&country=FR): $0.02 USDC. Accounts on time, size, turnover and result where published, insolvency and winding-up from official registers (GB, FR, NO, FI, NL with kvk); healthy, watch or distressed.
- [European company check (KYB)](https://factline.dev/v1/kyb/check?name=Google%20Ireland&country=IE&vat=IE6388047V): $0.05 USDC. Register record + sanctions and PEP on the company, directors, owners and parent companies + VAT match + Peppol + website + Dutch insolvency, one verdict.
- [Supplier invoice check](https://factline.dev/v1/invoice/check?id=7740001454&country=PL&vat=PL7740001454&iban=PL62102010260000190206882106): $0.08 USDC. Before paying a supplier invoice: company check (register, sanctions and PEP on company, directors, owners and parent companies, VAT, insolvency) plus IBAN validity and country, Polish whitelist accounts and sender email; pass, review or hold.
- [Peppol e-invoicing lookup](https://factline.dev/v1/einvoice/peppol?vat=BE0400378485): $0.003 USDC. Is a company on Peppol, its participant ids and which documents it receives, by VAT, company number or name.
- [KYC onboarding check](https://factline.dev/v1/kyc/check?name=Jan%20de%20Vries&email=jan%40example.nl&phone=%2B31612345678): $0.01 USDC. Sanctions + email + phone + EU VAT in one call, one verdict.
- [Sanctions screening](https://factline.dev/v1/sanctions/screen?name=Sergey%20Lavrov): $0.005 USDC. Fuzzy name screening against the EU, UN, UK and US OFAC sanctions lists in one call (merged, refreshed weekly), scored possible matches with list memberships.
- [PEP screen](https://factline.dev/v1/pep/screen?name=Mark%20Rutte): $0.005 USDC. Politically exposed persons: heads of state/government and ministers worldwide, central bank governors, MEPs, national MPs (EU/EEA/UK/US/CH), from Wikidata (CC0). Batch of 25: /v1/pep/batch, $0.03 USDC.
- [Company register lookup](https://factline.dev/v1/company/lookup?name=ASML%20Holding&country=NL): $0.008 USDC. Official registers: GLEIF (global LEI, incl. Dutch LEI holders with KvK number), UK Companies House, Ireland CRO, France SIRENE, Norway Enhetsregisteret, Finland PRH, Czechia ARES, Slovakia RPO, Estonia e-Business Register, Belgium KBO, Poland VAT whitelist (by NIP).
- [EU VAT check](https://factline.dev/v1/eu/vat?vat=IE6388047V): $0.003 USDC. Validate any EU VAT number via the European Commission VIES service; company name and address where shared.
- [Crypto wallet screening](https://factline.dev/v1/sanctions/wallet?address=0x0330070fd38ec3bb94f58fa55d40368271e9e54a): $0.003 USDC. Is this wallet address on the US OFAC sanctions list? Exact match, weekly refresh.
- [Sanctions batch](https://factline.dev/v1/sanctions/batch?names=Vladimir%20Putin;Factline;Jan%20de%20Vries): $0.03 USDC for up to 25 names against the EU, UN, UK and US OFAC lists: possible-match flag, top score and up to 3 matches per name.
- [Email verification](https://factline.dev/v1/email/verify?email=jan.jansen%40gmial.com): $0.002 USDC. Syntax, MX, disposable, role and free-provider flags, typo suggestion, SPF/DMARC, one verdict.
- [Phone verification](https://factline.dev/v1/phone/verify?phone=%2B31612345678): $0.003 USDC. Any country: valid, E.164 and national format, country, line type (mobile, landline, VoIP, premium).
- [Public tenders](https://factline.dev/v1/eu/tenders?country=NL&cpv=72): $0.005 USDC. Open EU tenders from TED by country, CPV and keywords, plus Dutch national tenders from TenderNed.
- [Dutch insolvency check](https://factline.dev/v1/nl/insolvency?kvk=11998877): $0.01 USDC. Is a Dutch company bankrupt or in suspension of payments (Centraal Insolventieregister), by KvK number or name.
- [Domain check](https://factline.dev/v1/domain/check?domain=example.nl): $0.003 USDC. Domain age and registrar (RDAP), expiry, email setup (MX/SPF/DMARC), disposable domain, risk flags.
- [IBAN check](https://factline.dev/v1/iban/check?iban=NL91ABNA0417164300): $0.001 USDC. Length, mod-97 checksum, SEPA, Dutch bank name.
- [EORI check](https://factline.dev/v1/eu/eori?eori=IE6388047V): $0.003 USDC. EU customs number valid or not, trader name/address where published (European Commission).

## Dutch addresses, neighbourhoods and vehicles
- [Free address lookup](https://factline.dev/v1/home/basic?postcode=3511LX&house_number=1): building year, floor area, use, neighbourhood headline figures, liveability percentile.
- [Full address report](https://factline.dev/v1/home/report?postcode=3511LX&house_number=1): $0.04 USDC via x402. Adds energy label details, nearest schools with results, crime vs national rate, monuments, permits nearby, ground height, noise and air quality, income, energy, 18 amenity distances, liveability breakdown.
- [Compare addresses](https://factline.dev/v1/home/compare?addresses=3511LX%201;2517AS%20100): $0.08 USDC. 2 to 5 addresses side by side with the best per metric.
- [Neighbourhood profile](https://factline.dev/v1/neighbourhood?postcode=2517AS): $0.01 USDC. Neighbourhood data without an exact address.
- [Address lookup](https://factline.dev/v1/address/lookup?postcode=2517AS&house_number=100): $0.002 USDC. Validate and geocode: official BAG address, coordinates, BAG ids, municipality, neighbourhood code.
- [Reverse geocoding](https://factline.dev/v1/address/reverse?lat=52.0836&lon=4.2919): $0.002 USDC. Coordinates to the nearest official BAG address with distance, postcode and CBS neighbourhood.
- [Vehicle comparison](https://factline.dev/v1/vehicle/compare?plates=GT722F;G941RB): $0.004 USDC. 2-3 plates side by side with red flags.
- [APK alert](https://factline.dev/v1/vehicle/apk?licence_plate=GT722F): $0.001 USDC. APK expiry, days left, status band.
- [Postcode addresses](https://factline.dev/v1/postcode/addresses?postcode=2517AS): $0.005 USDC. All official addresses in a 6-character postcode.
- [Energy label](https://factline.dev/v1/energy-label?postcode=2517AS&house_number=100): $0.005 USDC. Registered energy label of one home, with dates.
- [Crime](https://factline.dev/v1/crime?postcode=2517AS): $0.003 USDC. Registered crime per 1,000 residents by type vs the national rate.
- [House prices](https://factline.dev/v1/house-prices?postcode=2517AS): $0.003 USDC. Neighbourhood WOZ value and trend, municipality sale prices vs national.
- [Batch enrichment](https://factline.dev/v1/batch/addresses?addresses=3511LX%201;2517AS%20100): $0.015 USDC for up to 10 addresses: verified address, coordinates, neighbourhood, liveability, crime vs national, postcode home value; add include=energy_label for labels.
- [Rent check](https://factline.dev/v1/rent-check?postcode=2517AS&house_number=100): $0.01 USDC. Estimated rent points (WWS), social/middle/free-sector segment and approximate maximum rent for a Dutch home.
- [Flood risk](https://factline.dev/v1/flood-risk?postcode=2517AS&house_number=100): $0.004 USDC. Annual flood probability (any water, over 20/50/200 cm), 2050 and 2100 scenarios, worst-case water depth and ground height, from Rijkswaterstaat LIWO.
- Watchlists (API key): POST /v1/watch {kind: 'sanctions'|'apk', value, webhook?} re-screens names on every sanctions list change and checks plates daily; GET /v1/watch/alerts.
- Every paid response includes a "related" list: follow-up calls for the same place with their prices.
- [Free vehicle check](https://factline.dev/v1/vehicle/basic?licence_plate=GT722F): make, model, age, APK expiry, insurance, open recall, odometer verdict.
- [Full vehicle report](https://factline.dev/v1/vehicle/report?licence_plate=GT722F): $0.02 USDC. Adds APK inspection history with defects, recall details, specs, import/taxi history, risk flags.
- [Free car model reliability](https://factline.dev/v1/vehicle/model?make=Volkswagen&model=Golf): APK defect rate vs average, top 10 APK defects, recalls, open-recall and odometer-fraud shares for ~400 models.
- [Free schools near a postcode](https://factline.dev/v1/schools?postcode=3511LX): nearest primary and secondary schools with end-of-primary test results and exam pass rates.
- Focused MCP servers (fewer tools, better selection): [KYC and compliance](https://factline.dev/mcp/kyc), [Dutch homes and places](https://factline.dev/mcp/nl), [Dutch vehicles](https://factline.dev/mcp/vehicles). Codex CLI: codex mcp add factline-kyc --url https://factline.dev/mcp/kyc . Setup for Claude, ChatGPT, Codex, Cursor, Copilot, Gemini, LangChain, OpenAI Agents SDK, Vercel AI SDK and n8n: [https://factline.dev/agents](https://factline.dev/agents)
- [MCP server](https://factline.dev/mcp): paid compliance tools supplier_invoice_check, company_dossier, company_health, eu_company_check, peppol_lookup, kyc_check, nl_insolvency_check, eu_tenders_search, pep_screen, pep_batch, eu_sanctions_screen, eu_sanctions_batch, eu_sanctions_wallet, email_verify, phone_verify, eu_vat_check, eu_eori_check, domain_check, iban_check; paid Dutch tools nl_home_report, nl_home_compare, nl_neighbourhood, nl_address_lookup, nl_address_reverse, nl_address_batch, nl_energy_label, nl_crime, nl_house_prices, nl_flood_risk, nl_rent_check, nl_vehicle_report; free tools nl_home_basic, nl_vehicle_basic, nl_neighbourhood_summary, nl_car_model, nl_schools_near. Paid tools take x402 or a Factline API key (Authorization: Bearer fl_live_...).
- [Catalog](https://factline.dev/catalog) and [OpenAPI](https://factline.dev/openapi.json).

## Pages
- [Neighbourhoods](https://factline.dev/nl), [postcodes](https://factline.dev/postcode) and [car models](https://factline.dev/cars), in English.

## Notes
- Neighbourhood figures are averages for the CBS neighbourhood, not the individual home.
- No personal data: no owners, no WOZ value per home.
- Failed or partial reports return 503 and are never charged.
- Companies can use a monthly-billed API key instead of x402: send the header "Authorization: Bearer fl_live_...". Request one at [business](https://factline.dev/business).
- Uptime and source health: [status](https://factline.dev/status).