Documentation
Factline checks people, companies and places against official records: sanctions and PEP lists, company and insolvency registers, VIES, EORI and IBAN, plus Dutch address, neighbourhood and vehicle data in English. Every answer carries its source.
Start in one minute
1. Free call. The first 5 paid checks a day need no key or wallet. The answer carries the header X-Factline-Free-Call with the count:
curl -i "https://factline.dev/v1/sanctions/screen?name=Acme+Trading+Ltd"
2. Out of free calls? The answer is a 402 that says so. Get a starter key (100 credits, 14 days, no email):
curl -X POST https://factline.dev/v1/key/trial -H "content-type: application/json" -d '{}'
3. Paid call with the key:
curl "https://factline.dev/v1/sanctions/screen?name=Acme+Trading+Ltd" -H "x-api-key: fl_live_..."
4. MCP instead? Claude Code: claude mcp add --transport http factline-kyc https://factline.dev/mcp/kyc. Codex CLI: codex mcp add factline-kyc --url https://factline.dev/mcp/kyc.
Dutch data tools
For the Dutch tools, add a custom connector with this URL: https://factline.dev/mcp/chat (Claude) or https://factline.dev/mcp/gpt (ChatGPT developer mode). No login needed. Five free tools:
nl_home_basic | Facts about one address: year built, floor area, use, neighbourhood headline, liveability. |
nl_neighbourhood_summary | Headline facts about the neighbourhood around a postcode: home values, crime vs national rate, distances to shops, GP, school, station. |
nl_vehicle_basic | Licence plate check: make, model, age, APK expiry, insurance, open recall, odometer verdict. |
nl_car_model | How reliable a car model is: APK defect rate vs all models, most common defects, recalls. |
nl_schools_near | Nearest primary and secondary schools to a postcode, with test results and exam pass rates. |
Try: “What is the neighbourhood like around 2517AS?” · “When does the APK of GT-722-F expire?” · “When was Visschersplein 1 in Utrecht built?”
For developers and AI agents
Setup for every MCP client and agent framework: /agents. REST and MCP with pay-per-call in USDC (x402). See llms.txt, the catalog and OpenAPI. Agent MCP endpoint: https://factline.dev/mcp. Companies can use a monthly-billed API key instead of x402. To make your agent run the checks every time, install the Factline skills: npx skills add factline-dev/factline-skills.
Paid endpoints
Pay per call in USDC on Base or Solana (x402), or use an API key billed monthly. Failed calls are not charged.
/v1/address/lookup | $0.002 | Validate and geocode a Dutch address: canonical address, lat/lon, BAG ids, municipality, province and CBS neighbourhood code. |
/v1/address/reverse | $0.002 | Reverse geocode Dutch coordinates to the nearest official address: street, house number, postcode, city, BAG ids and CBS neighbourhood. |
/v1/email/verify | $0.002 | Verify an email address: syntax, mail servers (MX), disposable domain, role and free-provider address, typo suggestion, SPF/DMARC. |
/v1/credits/topup | $2 | Prepaid credits for x402 wallets: pay 2 USDC once, get an API key with 1,250 credits (20% under per-call prices), valid 12 months. |
/v1/fx/rate | $0.001 | Official exchange rates: ECB euro reference rates for about 30 currencies with cross rates and conversion, today or any working day in the last 90 days (invoice dates). |
/v1/eu/vat | $0.003 | Validate an EU VAT number via the European Commission's VIES: valid or not, with registered company name and address where the member state shares them. |
/v1/vehicle/apk | $0.001 | APK (MOT) status of a Dutch vehicle: expiry date, days left and a status band (expired, due within 30/90 days, ok). |
/v1/postcode/addresses | $0.005 | All official addresses in a Dutch 6-character postcode (BAG), with house letters, additions, BAG ids and coordinates. |
/v1/sanctions/wallet | $0.003 | Screen a crypto wallet address against the US OFAC sanctions list (digital currency addresses): sanctioned or not, with the listed entity. |
/v1/iban/check | $0.001 | IBAN validation: country length and mod-97 checksum, SEPA membership, Dutch bank name. |
Limits
Free use is limited to 30 requests per minute. Neighbourhood figures are CBS neighbourhood averages, not for the individual home. No personal data: no owners and no individual property values.