This is an n8n community node package. It lets you use Ambriel's Compliance Intelligence Platform in your n8n workflows — AML screening, company intelligence (KYB), fraud detection, and identity lookups.

Ambriel is a compliance intelligence platform that helps businesses screen entities, assess company risk, detect transaction fraud, and verify identities through a single API.

n8n is a fair-code licensed workflow automation platform.

Table of Contents

• Installation
• Credentials
• Compatibility
• Nodes & Operations
  • Ambriel Company
  • Ambriel AML
  • Ambriel Fraud
  • Ambriel Lookup
  • Ambriel Utilities
• Output Modes
• Binary PDF Support
• Example Workflow
• Resources
• Version history

Installation

1. In n8n, go to Settings → Community Nodes.
2. Select Install.
3. Enter @ambriel-io/n8n-nodes-ambriel as the npm package name.
4. Click Install.

For detailed instructions, follow the n8n community nodes installation guide.

Requires n8n v1.0+ (recommended: v1.30+).

Credentials

Ambriel uses API key authentication. All nodes share a single credential.

Obtaining an API Key

1. Sign in to your Ambriel Dashboard.
2. Navigate to Settings → API Keys.
3. Create a new API key and copy it.

Credential Fields

| Field | Type | Description | |-------|------|-------------| | API Key | Password | Your Ambriel API key from the dashboard | | Environment | Select | Production (api.ambriel.io) | | Base URL | String | (Optional) Custom API base URL override |

The credential is automatically tested on creation using GET /v1/me.

Compatibility

• Node.js: v22 or higher
• n8n: v1.0+
• Package: @ambriel-io/n8n-nodes-ambriel v1.0

Tested against n8n v1.30+ and the Ambriel API v1.

Nodes & Operations

The package exposes a single Ambriel node with 5 resources and 17 operations. Every operation supports Simplified and Raw output modes.

Resource: Company

Search, assess, and retrieve company intelligence data.

| Operation | Method | Endpoint | Description | |-----------|--------|----------|-------------| | Search | GET | /v1/kyb/search | Search companies by name, registration number, or tax ID | | Lookup | GET | /v1/kyb/company/{countryCode}/number/{value} | Get full company details by registration number | | Lookup by VAT | GET | /v1/kyb/company/{countryCode}/vat/{value} | Get full company details by VAT number | | Assess | POST | /v1/kyb/evaulate | Evaluate company risk with configurable scoring strategy | | Get Report | GET | /v1/kyb/assessment/{id}/report | Download assessment report as signed URL or binary PDF |

Supported countries: UK, DE, FR, NL, BE, ES, LU, RO, PL

Assessment parameters:

• Strategy — SUM_OF_RISK_SCORES, NORMALIZED_SCORE, or MAX_RISK_WINS
• Categories — Filter by risk rule categories (ownership, jurisdiction, financial, operational, reputation, aml_sanctions, other)
• Generate PDF — Optionally trigger a PDF report on assessment

Simplified output (Assess)

{
  "id": 123,
  "score": 42,
  "level": "Medium",
  "strategy": "SUM_OF_RISK_SCORES",
  "thresholdMin": 30,
  "thresholdMax": 60,
  "appliedRuleCount": 5,
  "checkedRuleCount": 12
}

Resource: AML

Screen entities against sanctions, crime, PEP (Politically Exposed Persons), and watchlists.

| Operation | Method | Endpoint | Description | |-----------|--------|----------|-------------| | Screen | POST | /v1/aml/screen | Screen a person or company against global watchlists | | List Entities | GET | /v1/aml/entities | List all previously screened entities (paginated) | | Get Entity | GET | /v1/aml/entities/{id} | Get details of a single entity | | Create Entity | POST | /v1/aml/entities | Create a new entity for monitoring |

Screening inputs:

• Entity Type — Person or Company
• Name — Full name of the person or entity
• Country — Nationality (person) or registration country (company). ISO Alpha-2 code.
• Date of Birth — YYYY-MM-DD format (persons only)

Simplified output (Screen)

{
  "found": 2,
  "outOf": 1000000,
  "page": 1,
  "searchTimeMs": 145,
  "matches": [
    {
      "name": "John Doe",
      "schema": "Person",
      "country": "US",
      "confidence": 98,
      "score": "0.98"
    }
  ]
}

Resource: Fraud

Score transactions and detect fraud using Ambriel's scoring engine.

| Operation | Method | Endpoint | Description | |-----------|--------|----------|-------------| | Score Transaction | POST | /v1/transactions/ | Score a transaction using fraud detection rules | | Get Transaction | GET | /v1/transactions/{id} | Retrieve a previously scored transaction | | Transaction Action | POST | /v1/transactions/{id}/actions | Record a post-transaction action (refund, chargeback, etc.) |

Scoring inputs:

• Transaction ID, Type (order/transaction/login), Action Type (purchase/refund/transfer, etc.)
• Amount & Currency (ISO 4217)
• Customer — ID, name, email, IP address
• Additional fields — Payment mode, provider, merchant ID, details URL

Simplified output (Score Transaction)

{
  "success": true,
  "state": "approve",
  "score": 64,
  "responseTimeMs": 233,
  "appliedRules": [
    {
      "code": "BI4969",
      "name": "Card Country AF,AD",
      "category": "bin",
      "score": 30
    }
  ]
}

Resource: Lookup

Perform quick lookups against Ambriel's data sources.

| Operation | Method | Endpoint | Description | |-----------|--------|----------|-------------| | Email | POST | /v1/email | Email reputation, breach data, domain analysis | | Phone | POST | /v1/phone | Phone carrier, type, validity, and country | | IP | POST | /v1/ip | IP geolocation, VPN/proxy/TOR detection | | BIN | POST | /v1/bin | Card BIN details (bank, brand, type, country) |

Simplified output (Email)

{
  "email": "[email protected]",
  "domainDisposable": false,
  "numberOfBreaches": 3,
  "breachNames": ["LinkedIn", "Adobe", "Collection-1"],
  "domainFree": true
}

Resource: Utilities

Check your Ambriel account information.

| Operation | Method | Endpoint | Description | |-----------|--------|----------|-------------| | Usage | GET | /v1/me | Current account usage and quota information |

Output Modes

Every operation supports two output modes:

| Mode | Description | |------|-------------| | Simplified (default) | Returns a structured set of key fields relevant to the operation | | Raw API Response | Returns the complete JSON response from the Ambriel API |

Select the mode via the Output Mode dropdown in each node's parameters.

Binary PDF Support

The Company → Get Report operation can download assessment reports directly as binary PDF files, making them available to subsequent nodes for upload to Dropbox, Google Drive, Slack, email, or any other n8n-compatible service.

To enable this, set Download as Binary to true and specify the Binary Property name (default: data).

Example Workflow

A typical compliance workflow might look like:

Webhook
  ↓
Ambriel → Company → Search     (find company by name)
  ↓
Ambriel → Company → Assess     (evaluate risk)
  ↓
IF → (risk > Medium)
  ↓
Slack                           (alert compliance team)
  ↓
Ambriel → Company → Get Report (generate PDF report)
  ↓
Google Drive                    (store report)

Resources

• Ambriel API Documentation
• Ambriel Dashboard
• n8n Community Nodes Documentation
• n8n Node Building Guide
• n8n Community Forum

Version History

1.0.0 (Current)

| Company resource — Search, Lookup (number & VAT), Assess, Get Report | AML resource — Screen, List Entities, Get Entity, Create Entity | Fraud resource — Score Transaction, Get Transaction, Transaction Action | Lookup resource — Email, Phone, IP, BIN lookups | Utilities resource — Account usage

• Simplified & Raw output modes for all operations
• Binary PDF download support for reports
• Single API key credential with Sandbox/Production environments

1.1.0 (Planned)

• Identity Verification
• AML Assessment
• Monitoring & Company Monitoring
• Webhooks
• Enhanced pagination (Return All / Limit)
• Binary PDF download (standalone)

1.2.0 (Planned)

• AI Helper Nodes
• Decision Node (risk-based routing)
• Wait for Assessment (async polling)
• Batch Processing
• Async Job submission