Description
!Ambriel Compliance Intelligence Platform
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
- Output Modes
- Binary PDF Support
- Example Workflow
- Resources
- Version history
- Node.js: v22 or higher
- n8n: v1.0+
- Package:
@ambriel-io/n8n-nodes-ambrielv1.0 - Strategy —
SUMOFRISKSCORES,NORMALIZEDSCORE, orMAXRISKWINS - Categories — Filter by risk rule categories (ownership, jurisdiction, financial, operational, reputation, aml_sanctions, other)
- Generate PDF — Optionally trigger a PDF report on assessment
– Ambriel Company
– Ambriel AML
– Ambriel Fraud
– Ambriel Lookup
– Ambriel Utilities
—
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
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:
#### Simplified output (Assess)
{
"id": 123,
"score": 42,
"level": "Medium",
"strategy": "SUMOFRISK_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:
Person or Company#### 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:
#### 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": "sam@example.com",
"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
—
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
