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.

More: setup for every client, OpenAPI, a signed receipt.

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_basicFacts about one address: year built, floor area, use, neighbourhood headline, liveability.
nl_neighbourhood_summaryHeadline facts about the neighbourhood around a postcode: home values, crime vs national rate, distances to shops, GP, school, station.
nl_vehicle_basicLicence plate check: make, model, age, APK expiry, insurance, open recall, odometer verdict.
nl_car_modelHow reliable a car model is: APK defect rate vs all models, most common defects, recalls.
nl_schools_nearNearest 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.002Validate and geocode a Dutch address: canonical address, lat/lon, BAG ids, municipality, province and CBS neighbourhood code.
/v1/address/reverse$0.002Reverse geocode Dutch coordinates to the nearest official address: street, house number, postcode, city, BAG ids and CBS neighbourhood.
/v1/email/verify$0.002Verify an email address: syntax, mail servers (MX), disposable domain, role and free-provider address, typo suggestion, SPF/DMARC.
/v1/credits/topup$2Prepaid 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.001Official 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.003Validate 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.001APK (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.005All official addresses in a Dutch 6-character postcode (BAG), with house letters, additions, BAG ids and coordinates.
/v1/sanctions/wallet$0.003Screen a crypto wallet address against the US OFAC sanctions list (digital currency addresses): sanctioned or not, with the listed entity.
/v1/iban/check$0.001IBAN 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.