Invoice Check

{
  "bank": {
    "country": "PL",
    "iban": "PL62 1020 1026 0000 1902 0688 2106",
    "reasons": [],
    "sepa": true,
    "valid": true
  },
  "checks": {
    "domain": "not requested (send domain)",
    "insolvency": "Dutch companies only",
    "register": {
      "source": "wl-api.mf.gov.pl",
      "status": "ok"
    },
    "sanctions": {
      "result": {
        "disclaimer": "Automated name screening aid, not legal advice. A match is a possible match: confirm identity with dates of birth, nationality and the official list before acting. Covers the targeted (asset-freeze/SDN) lists named in list.sources, refreshed weekly; not sectoral or export-control restrictions, or other national lists. A clean result is not clearance.",
        "list": {
          "entities": 25681,
          "loaded_at": "2026-10-12T00:20:52.400Z",
          "sources": [
            {
              "dated": "2026-09-22",
              "list": "EU",
              "name": "EU consolidated financial sanctions list (European Commission)"
            },
            {
              "dated": "2026-10-10",
              "list": "UN",
              "name": "UN Security Council consolidated sanctions list"
            },
            {
              "dated": "08/10/2026",
              "list": "UK",
              "name": "UK Sanctions List (FCDO/OFSI)"
            },
            {
              "dated": "OFAC SDN",
              "list": "US",
              "name": "US OFAC Specially Designated Nationals (SDN) list"
            }
          ]
        },
        "matches": [],
        "possible_match": false,
        "query": {
          "birth_year": null,
          "name": "ORLEN SPÓŁKA AKCYJNA",
          "threshold": 85,
          "type": "entity"
        },
        "source": "European Commission FSF; UN Security Council; UK FCDO; US Treasury OFAC"
      },
      "status": "ok"
    },
    "vat": {
      "result": {
        "address": "CHEMIKÓW 7, 09-411 PŁOCK",
        "checked_at": "2026-10-12T16:02:25.054Z",
        "country_code": "PL",
        "name": "ORLEN SPÓŁKA AKCYJNA",
        "source": "European Commission VIES (VAT Information Exchange System)",
        "valid": true,
        "vat_number": "PL7740001454"
      },
      "status": "ok"
    }
  },
  "einvoicing": {
    "accepts": [],
    "can_receive_invoices": false,
    "on_peppol": false,
    "participant_ids": []
  },
  "explain": {
    "disclaimer": "Automated screening aid, not legal or tax advice. Sanctions matches are possible matches; confirm against the official lists.",
    "limits": "Checks the supplier and the invoice details against official records. It cannot confirm who holds the bank account: for Dutch and other SEPA accounts use your bank's payee name check (Verification of Payee) before the first payment.",
    "verdict": "pass: supplier found and active, payment details consistent, nothing flagged; review: something needs a human look before paying (IBAN abroad, account not on the Polish whitelist, VAT mismatch, new website, email mismatch, insolvency); hold: do not pay yet (possible sanctions match on the company, a director, an owner or a parent company, or an invalid IBAN); incomplete: a source was down, retry."
  },
  "flags": [],
  "group": {
    "direct_parent": null,
    "direct_parent_note": "no LEI found for this company, so no parent data",
    "lei": null,
    "source": "GLEIF Level 2 relationship data (CC0)",
    "ultimate_parent": null,
    "ultimate_parent_note": null
  },
  "notes": [
    "IBAN is registered to this company on the Polish VAT whitelist"
  ],
  "people": "not published openly by this register",
  "sender_email": "not sent (send email)",
  "source": "Official company registers (see checks.register.source); GLEIF; EU, UN, UK and US sanctions lists; EU VIES; RDAP and DNS; Dutch Centraal Insolventieregister; Peppol Directory; ISO 13616 IBAN; Polish VAT whitelist (bank accounts); DNS",
  "supplier": {
    "address": "CHEMIKÓW 7, 09-411 PŁOCK",
    "bank_accounts": [
      "PL09102010260000110207607072",
      "PL28102010260000140207626759"
    ],
    "country": "PL",
    "incorporated": "1993-07-05",
    "legal_form": null,
    "lei": null,
    "name": "ORLEN SPÓŁKA AKCYJNA",
    "registry": "Polish VAT taxpayer register (Biala lista, Ministry of Finance)",
    "registry_id": "7740001454",
    "status": "active",
    "vat_status": "active VAT payer"
  },
  "verdict": "pass"
}

# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i 'https://factline.dev/v1/invoice/check?country=PL&iban=PL62102010260000190206882106&id=7740001454&vat=PL7740001454'

# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - 'https://factline.dev/v1/invoice/check?country=PL&iban=PL62102010260000190206882106&id=7740001454&vat=PL7740001454' \
  | grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decode

// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

// Pays at most $0.08 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.08" });
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? ToolVet checks it first for $0.005. Pay for that from a separate
// client: this one is capped at $0.08 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Ffactline.dev%2Fv1%2Finvoice%2Fcheck
const res = await pay("https://factline.dev/v1/invoice/check?country=PL&iban=PL62102010260000190206882106&id=7740001454&vat=PL7740001454");
console.log(res.status, await res.text());

# pip install "x402[requests,evm]"
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

# Pays at most $0.08 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.08"})
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))

with x402_requests(client) as session:
    res = session.get("https://factline.dev/v1/invoice/check?country=PL&iban=PL62102010260000190206882106&id=7740001454&vat=PL7740001454")
    print(res.status_code, res.text)