sumsub-analyze-regulation
Analyze a regulation document (PDF or text) and produce a Sumsub configuration plan — mapping regulatory requirements to Sumsub entities (levels, questionnaires, PoA presets, TM rules, workflows, AML resolution rules). TRIGGER when the user provides a regulation PDF, legal act, or compliance require
By sumsub · 840 installs
npx skills add sumsub/agent-skills --skill sumsub-analyze-regulation
Source repository · Upstream listing
Sumsub — Analyze Regulation
Reads a regulation document and produces a structured Sumsub configuration plan — mapping each regulatory requirement to the Sumsub entities that satisfy it, with a clear split between what can be configured now via skills and what requires the Sumsub Dashboard .
This is a planning skill only . It produces a text description, never JSON payloads or API calls.
Workflow
Step 1 — Gather context
Before analyzing, collect:
Jurisdiction — if the document covers multiple countries or is ambiguous, ask explicitly:
"This regulation covers [list of countries]. Which jurisdiction should the plan focus on?"
Do not generate a plan for all jurisdictions simultaneously without a direct request to do so.
Business type — crypto exchange, neobank, iGaming, fintech, or other. Ask if not clear from the document.
Client types — individuals, companies, or both.
Existing Sumsub setup — has the user already configured anything? Avoid suggesting duplicates.
Step 2 — Analyze (think before responding)
Use extended thinking before formulating the response. Extract from the document:
Customer identification requirements (who must be identified, what data is required)
Acceptable identity documents (national ID, passport, tax number, etc.)
Address verification requirements (what documents are accepted, maximum age)
Enhanced Due Diligence conditions (what triggers EDD)
Source of funds / wealth / PEP data collection requirements
AML screening obligations (PEP / sanctions / adverse media) and how screening hits must be handled (false positive clearing, PEP review policy, escalation of confirmed matches)
Transaction monitoring requirements (thresholds, suspicious patterns, crypto Travel Rule)
Periodic re KYC obligations (how often customers must be re verified)
What is out of scope for Sumsub (data retention timelines, regulatory reporting, sanctions list maintenance)
Step 3 — Validate understanding first
After analysis, present a short "My Understanding" block — bullet points of extracted requirements — and ask:
"Have I understood the key requirements correctly? Anything to add or correct?"
Do not generate the full plan until the user confirms. This is mandatory.
Step 4 — Generate the plan
Only after user confirmation, produce the full configuration plan using the [output format]( output format) below.
Sumsub Capability Map
A. Verification Levels — sumsub create level
Defines the sequence of verification steps an applicant must complete. Each step is a docSet .
Available docSet types:
Type Purpose
IDENTITY Document verification: PASSPORT, ID CARD, DRIVERS, RESIDENCE PERMIT, VOTER ID, etc. Can be restricted by issuing country.
SELFIE / SELFIE2 Biometrics and liveness.
APPLICANT DATA Personal data collection: full name, date of birth, address, nationality, tax number (TIN/CPF/CNPJ/etc.).
PROOF OF RESIDENCE / PROOF OF RESIDENCE2 Address document verification. References a PoA preset by poaStepSettingsId .
PHONE VERIFICATION / EMAIL VERIFICATION Contact verification via OTP.
QUESTIONNAIRE / QUESTIONNAIRE2–4 Custom form. References a questionnaire definition by questionnaireDefId .
E KYC Non document electronic verification against external databases. See [E KYC section]( e kyc non document electronic verification).
DEVICE CHECK Device intelligence and fingerprinting. Requires DEVICE INTELLIGENCE license.
COMPANY KYB: company info collection.
COMPANY DATA KYB: company data fields.
COMPANY DOCUMENTS KYB: corporate documents upload.
COMPANY BENEFICIARIES KYB: UBOs and representatives verification.
ACCREDITED INVESTOR Accredited investor qualification.
E SIGN Electronic signature capture.
TR RECIPIENT INFORMATION Travel Rule recipient data collection.
Level properties:
applicantType : individual or company
requiredIdDocs : the ordered list of docSets + optional includedCountries / excludedCountries
disableWatchlists : set to true if tenant has WATCHLISTS entitlement but needs to disable AML Screening for a particular level
crossCheckPresetId : cross check preset for AML screening
IDENTITY — document type codes
Sumsub uses generic IdDocType values regardless of what the document is locally called. Map the regulation's document names to these types:
Generic document class Sumsub IdDocType
International / biometric passport PASSPORT
National identity card (any country) ID CARD
Driver's licence DRIVERS
Residence / immigration permit RESIDENCE PERMIT
Voter ID VOTER ID
Documents with no dedicated Sumsub type (e.g. tax cards, social security cards) OTHER DOCS
includedCountries / excludedCountries use ISO 3166 alpha 3 (e.g. BRA , USA , DEU ).
Two sided capture should be specified whenever a mandatory identifier (tax number, national number) appears on the back of the document.
SELFIE — liveness options ( videoRequired )
Value Description Use when
passiveLiveness Default. Advanced passive liveness, no movement required. Standard KYC — no stricter regulatory mandate.
activeLiveness Active motion challenge (head movement detection). Regulation explicitly requires active/dynamic liveness.
enabled Short video — applicant pronounces displayed digits. Regulation requires video identity check.
photoRequired Photo only selfie, no liveness. Use only when explicitly requested; generally insufficient for AML compliance.
staticLiveness Single frame analysis. Use only when explicitly requested.
For most AML/KYC regulations without a specific liveness requirement, default to passiveLiveness .
APPLICANT DATA — common field names
Standard personal data fields:
Field name Meaning
firstName First / given name
lastName Last / family name
dob Date of birth
country Country of residence (ISO 3166 alpha 3)
town City / town
street Street address
postCode Postal / ZIP code
nationality Nationality (ISO 3166 alpha 3)
placeOfBirth Place of birth
tin Tax identification number (TIN, CPF, SSN, BSN, etc.)
When a regulation mandates collection of a national tax or identity number, map it to tin and mark it required: true .
DEVICE CHECK — what it detects
When DEVICE INTELLIGENCE license is active, this step flags: emulators, rooted/jailbroken devices, VPN/proxy/Tor connections, remote desktop software, and crypto mixer tools. Always note in the plan that this step silently falls back to disabled if the tenant lacks the entitlement — add a GET back verification step.
B. Questionnaires — sumsub create questionnaire
Custom forms for collecting applicant data not captured by document checks.
Common use cases: source of funds, source of wealth, employment, PEP self declaration, trading experience, risk profile.
Question types: text , textArea , date , dateTime , bool , select , selectDropdown , multiSelect , phone , countrySelect , countryMultiSelect , fileAttachment , multiFileAttachments .
Conditional logic: sections and items can be shown/hidden based on previous answers.
Risk scoring: each answer option can carry a score (0–100); scores sum automatically and can be referenced in downstream transaction monitoring rules.
One questionnaire per level. Group distinct topics (source of funds, PEP self declaration, risk profile…) as separate sections within a single questionnaire — not as separate questionnaires. Default to one QUESTIONNAIRE step per level. A separate level legitimately gets its own questionnaire (e.g. an EDD level with an extended questionnaire) — that is still one per level, not an exception. Only plan multiple questionnaires on the same level if the user explicitly asks for it.
C. Proof of Address Presets — sumsub create poa preset
Reusable configuration for what documents are accepted as proof of address.
Document categories:
governmentOrganization — government issued (voter registration, tax bill, etc.)
utilityProvider — utility bills
bank — bank statements and letters
mobileOperator — telecom bills
other
Key settings:
maxMonths per category — maximum document age
Cross validation: name/address comparison between identity document (POI) and address document (POA) — fuzzy or strict mode
PoI as PoA: accept the identity document itself as proof of address
Neobank blocklist: exclude documents from specific institutions (Revolut, N26, Wise, etc.)
Country specific overrides: different rules per country
D. E KYC (Non Document Electronic Verification)
⚠️ Requires separate activation per country through a Sumsub Customer Success Manager (CSM). License: E KYC TARGET .
Configured via sumsub create level once activated.
How it works: the applicant submits unique identifiers (TIN, document number, bank login) which are validated against external databases — no document photo required.
Two configuration modes:
1. Standalone E KYC docSet — electronic verification only; applicant cannot upload documents instead
2. IDENTITY with ekycAllowed: true — applicant chooses: upload document photo OR complete E KYC
Available database types: GOVERNMENT (national registries), CREDIT (credit bureaus), TELCO (telecom providers), BANKING , COMMERCIAL (business registries), CONSUMER , UTILITY , POSTAL , PROPRIETARY .
Verification methods: ENRICHMENT , ONE X ONE MATCHING , TWO X TWO MATCHING , VALIDITY CHECK .
Configuration rules:
Country coverage depends entirely on client's license activations — there is no universal list
Recommended to pair with a SELFIE step for biometric verification against database records
Activation steps: (1) contact CSM to request per country activation, (2) run sumsub create level .
E. Transaction Monitoring — sumsub create kyt rules
⚠️ Requires KYT license (and TRAVEL RULE for crypto, TM SCHEDULED EVENTS for periodic re KYC, KYT ANTI FRAUD for platform events).
Describes what to configure at plan time in plain language. sumsub create kyt rules translates each rule into a conditionEl SumScript expression and POSTs it to the API. New rules always start in test mode ( dryRun: true ) — activating them requires the dashboard.
Transaction types:
finance — financial transactions (fiat and crypto)
travelRule — crypto transactions subject to Travel Rule (FATF / VASP)
kyc — KYC related events
userPlatformEvent — login, signup, password reset, 2FA changes
scheduledEvent — periodic triggers (requires TM SCHEDULED EVENTS license)
Rule anatomy:
Condition — trigger (e.g., "incoming crypto transaction $10,000")
Action: score (add risk points), onHold (freeze transaction), awaitUser (request confirmation), reject (block)
Risk score (0–100) — cumulative; multiple rules sum their scores
Applicant change — move applicant to another level, trigger final rejection, or route to manual review
Case creation — auto create a compliance investigation case on rule match
Automated pre scoring enrichments (active for licensed tenants):
AML watchlists (PEP, sanctions, adverse media)
Crypto screening: Chainalysis, Elliptic, TRM Labs, Merkle Science, Crystal
Travel Rule processing
Device intelligence and fingerprinting
BIN lookup and payment method analytics
Periodic Re KYC (Scheduled Rules):
Trigger: applicants on level X for N days → reassign to a new level (triggers re verification)
Requires TM SCHEDULED EVENTS license
Required licenses for TM features: KYT , TRAVEL RULE , TM SCHEDULED EVENTS , KYT ANTI FRAUD , DEVICE INTELLIGENCE .
F. Workflows — sumsub create workflow
Graph based r