NameScan API
Programmatically access NameScan screening data, match results, reports, and ongoing monitoring with a stable REST API. Supergood builds and operates production-grade, unofficial NameScan integrations so your team can automate AML/KYC workflows without heavy custom engineering. Plain English: NameSc
What is NameScan?
NameScan is a cloud AML/KYC screening solution used by financial services, fintechs, payments, crypto platforms, and other regulated businesses to vet customers, vendors, and beneficial owners. Teams use NameScan to perform real-time checks against sanctions and watchlists, assess PEP exposure, detect adverse media, set up ongoing monitoring, and maintain evidence for regulators—all through a browser-based portal and batch/API options.
Core product areas include:
- Screening Services (Sanctions, Watchlists, PEP, Adverse Media)
- Ongoing Monitoring (daily/weekly re-screening with alerting)
- Case Review & Decisions (match resolution, notes, attachments)
- Reporting & Evidence (exportable screening reports, audit trails)
- Batch & API (bulk uploads, programmatic access)
Common data entities:
- Accounts, Users, Roles/Permissions (Compliance Analyst, Reviewer, Admin)
- Subjects (Individuals, Organizations, Beneficial Owners)
- Screenings (inputs, coverage, jurisdiction filters, status)
- Matches (list/source, entity details, confidence, risk level)
- Reports (PDF/JSON artifacts, timestamps, hash/checksum)
- Monitoring Subscriptions & Alerts (frequency, coverage, delivery targets)
- Decisions (true/false positive, under review, escalations)
The NameScan Integration Challenge
Compliance teams rely on NameScan daily, but turning portal-based screening flows into API-driven automation is non-trivial:
- List complexity: Multiple jurisdictions, frequent updates, and list versions impact match interpretation
- Matching nuance: Fuzzy matching, transliteration, aliases, and multi-lingual names drive false positives
- Case states: Decisions, notes, and evidence must be preserved with strict audit requirements
- Licensing & entitlements: Coverage (sanctions, PEP, adverse media) depends on plan and permissions
- Authentication & sessions: MFA/SSO and session lifecycles complicate headless access
- Asynchronous workflows: Ongoing monitoring and large searches can produce delayed or incremental results
How Supergood Creates NameScan APIs
Supergood reverse-engineers authenticated browser flows and network interactions to deliver a resilient API endpoint layer for your NameScan tenant.
- Handles username/password, SSO/OAuth, and MFA (SMS, email, TOTP) securely
- Maintains session continuity with automated refresh and change detection
- Normalizes responses so you can integrate once and rely on consistent objects across modules
- Aligns with customer entitlements and role-based permissions to ensure compliant access
- Preserves audit fidelity by including decision metadata, evidence hashes, and timestamps
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your modules, licensing, and authentication model.
- Supergood Builds and Validates Your API
We deliver a hardened NameScan adapter tailored to your workflows and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as NameScan evolves.
API Endpoints
Authentication
/sessionsEstablish a session using credentials. Supergood manages MFA (SMS, email, TOTP) and SSO/OAuth when enabled. Returns a short-lived auth token maintained by the platform.
Authentication
/sessions/refreshRefresh an existing token to keep sessions uninterrupted.
Screenings
/screeningsCreate a new screening for an individual or organization with coverage options and jurisdiction filters.
Screenings
/screeningsList screenings with filters and summary risk details.
Results & Reports
/screenings/{screeningId}/resultsRetrieve detailed matches, list sources, confidence, and a downloadable report artifact.
Monitoring
/monitoring/subscriptionsEnroll a subject in ongoing monitoring with coverage and alert preferences.
Use Cases
Screening & Monitoring Sync
- Mirror subjects and past screenings into your internal systems - Keep match summaries current for dashboards and analytics - Normalize risk categories and list sources across jurisdictions
Customer Onboarding Automation
- Trigger screenings at signup and before payouts or high-risk events - Auto-create cases with matches routed to reviewers in your platform - Attach documents and notes, then push decisions back to NameScan
Ongoing Monitoring & Alerts
- Enroll customers or counterparties into re-screening subscriptions - Deliver alerts to webhooks, Slack, or case management systems - Track escalation SLAs and resolve alerts programmatically
Compliance Reporting & Audit Trails
- Generate and archive screening reports with checksums - Sync decisions, reviewer notes, and timestamps to your compliance data lake - Provide regulators with consistent evidence across multiple data providers
Technical Specifications
Authentication
Username/password with MFA (SMS, email, TOTP) and SSO/OAuth where enabled; supports service accounts or customer-managed credentials
Response format
JSON with consistent resource schemas and pagination across modules
Rate limits
Tuned for enterprise throughput while honoring customer entitlements and usage controls
Session management
Automatic reauth and cookie/session rotation with health checks
Data freshness
Near real-time retrieval of screenings, matches, reports, and monitoring alerts
Security
Encrypted transport, scoped tokens, and audit logging; respects NameScan role-based permissions and PII handling requirements
Webhooks
Optional asynchronous delivery for monitoring alerts and long-running batch screenings
Latency
Sub-second responses for list/detail queries under normal load
Throughput
Designed for high-volume screening initiation and alert ingestion
Reliability
Retry logic, backoff, and idempotency keys minimize duplicate actions
Adaptation
Continuous monitoring for UI/API changes with rapid adapter updates
Frequently asked questions
Supergood supports workflows across Screening Services (Sanctions, Watchlists, PEP, Adverse Media), Ongoing Monitoring, Case Review/Decisions, and Reporting, subject to your licensing and entitlements. We scope coverage during integration assessment.
We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. Sessions are refreshed automatically with secure challenge handling.
Yes. We can download screening reports and include checksums and timestamps, with time-limited URLs and optional archival into your storage systems. Decision metadata, reviewer notes, and attachments are modeled explicitly in normalized responses.
Yes. We support creating subscriptions, delivering alerts via webhooks, and updating coverage/jurisdictions to match your risk policies.
NameScan coverage depends on your plan and entitlements. Supergood aligns with your licensed modules and normalizes responses while respecting rate limits, permissions, and data usage terms.