intelligentdata

n8n community node for the apexanalytix Intelligent Data API — address, tax, bank, business, sanctions, and director validation

Package Information

Downloads: 330 weekly / 426 monthly
Latest Version: 0.1.0-dev.185

Available Nodes

Intelligent Data
Validate addresses, tax IDs, bank accounts, and screen against global sanctions lists via the apexanalytix Intelligent Data API

Documentation

Intelligent Data — n8n Community Node

Community node for n8n that integrates with the apexanalytix Intelligent Data API for address, tax, bank, business, sanctions, and director validation.

Package: n8n-nodes-intelligentdata

Operations

Operation Endpoint Description
Address Validation POST /api/address/validate Validate and standardize a postal address
Tax Validation POST /api/tax/validate Validate a tax ID (VAT, TIN, GST, etc.)
Bank Validation POST /api/bank/validate Validate a bank account, routing number, or IBAN
Business Lookup POST /api/businessregistration/lookup Look up business registration details
Sanctions Screening POST /api/prohibited/lookup Screen against 90+ global prohibited/watch lists
Director Check POST /api/disqualifieddirectors/validate Check if a person is a disqualified director

Installation

From n8n Community Nodes

  1. In your n8n instance, go to Settings > Community Nodes
  2. Click Install a community node
  3. Enter n8n-nodes-intelligentdata
  4. Click Install

Self-hosted (manual)

cd ~/.n8n/custom
npm install n8n-nodes-intelligentdata

Restart n8n after installation.

Authentication

  1. In n8n, go to Credentials > Add Credential
  2. Search for Intelligent Data API
  3. Enter your API key (starts with svm)
  4. Click Save — the credential will be validated automatically

Get your API key from the Intelligent Data Portal.

Workflow Examples

Example 1: Validate New CRM Contacts

Trigger: Webhook (receives new contact data)
Nodes:

  1. Intelligent Data > Address Validation — Validate the contact's address
  2. IF node — Check isValid field
    • True: Update CRM with standardized address
    • False: Send Slack notification for manual review

Example 2: Daily Sanctions Screening

Trigger: Cron (daily at 6:00 AM)
Nodes:

  1. Postgres — Fetch active vendors from database
  2. SplitInBatches — Process vendors in batches of 10
  3. Intelligent Data > Sanctions Screening — Screen each vendor
  4. IF node — Check hasMatches field
    • True: Insert match into compliance review table
    • False: Continue to next vendor

Example 3: Full Vendor Onboarding Validation

Trigger: Webhook (new vendor submission form)
Nodes:

  1. Intelligent Data > Address Validation — Validate address
  2. Intelligent Data > Tax Validation — Validate tax ID
  3. Intelligent Data > Bank Validation — Validate bank details
  4. Intelligent Data > Sanctions Screening — Screen against prohibited lists
  5. Merge — Combine all validation results
  6. IF node — Check if all validations passed
    • True: Create vendor record in ERP
    • False: Send rejection email with details

Files

File Purpose
credentials/IntelligentDataApi.credentials.ts n8n credential type for API key authentication
nodes/IntelligentData/IntelligentData.node.ts Main node definition with all 6 operations
package.json npm package metadata with n8n node registration
tsconfig.json TypeScript configuration

Error Handling

The node surfaces API errors as n8n execution errors. Common error codes:

HTTP Status Cause Resolution
400 Missing required fields Check that all required input fields are mapped
401 Invalid API key Update your Intelligent Data API credential
429 Rate limit exceeded Enable Retry On Fail in the node settings and add a wait between batches
500 Server error Enable Retry On Fail with exponential backoff

Use n8n's Error Trigger node to set up global error handling for your workflows.

Development

cd sdks/n8n
npm install
npm run build     # Compile TypeScript to dist/
npm run lint      # Type check without emitting

To test locally, link the package into your n8n custom directory:

npm run build
ln -s "$(pwd)/dist" ~/.n8n/custom/node_modules/n8n-nodes-intelligentdata

Restart n8n to pick up changes.

Getting an API Key

  1. Sign up at portal.smartvmapi.com
  2. Navigate to Dashboard > API Keys
  3. Copy your API key (starts with svm)

Support

Discussion