Supergood | 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: NameScan is an anti-money laundering (AML) and know-your-customer (KYC) screening platform that lets compliance teams check individuals and organizations against global sanctions lists, politically exposed persons (PEPs), and adverse media, then track and document decisions. An unofficial API lets you programmatically pull screening records, matches, alerts, and reports—and push new screenings, monitoring subscriptions, and case decisions into NameScan.
For a tech company integrating with NameScan, this means you can ingest up-to-date screening results to drive onboarding decisions, sync alerts into case management, enrich risk scoring with PEP/sanctions flags, auto-generate compliance evidence, and keep internal systems (core banking, payments, crypto, lending, ERP, analytics, CRM) in lockstep. You can trigger screenings at signup, re-screen on risk events, resolve false positives in your product, attach supporting documents, and archive audit trails.
What is NameScan?
NameScan (https://namescan.io/) 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
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
Available Endpoints
Authentication
POST /sessions: Establish 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.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/sessions \
--header 'Authorization: Basic <Base64 encoded token>' \
--header 'Content-Type: application/json' \
--data '{
"username": "[email protected]",
"password": "<password>",
"mfa": { "type": "totp", "code": "123456" }
}'
Example response
{
"authToken": "eyJhbGciOi...",
"expiresIn": 3600,
"user": {
"id": "u_nscan_8b92de",
"name": "Compliance Analyst",
"entitlements": ["screenings", "matches", "reports", "monitoring"]
}
}
POST /sessions/refresh: Refresh an existing token to keep sessions uninterrupted.
Screenings
POST /screenings: Create a new screening for an individual or organization with coverage options and jurisdiction filters.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/screenings \
--header 'Authorization: Bearer <authToken>' \
--header 'Content-Type: application/json' \
--data '{
"subject": {
"type": "individual",
"givenName": "Maria",
"familyName": "Santos",
"dateOfBirth": "1985-09-12",
"nationality": "PH",
"countryOfResidence": "AU",
"aliases": ["M Santos"],
"identifiers": [{"type": "passport", "value": "P1234567"}]
},
"coverage": ["sanctions", "pep", "adverse_media"],
"jurisdictions": ["US", "EU", "UN", "AU"],
"fuzzyThreshold": 0.85,
"includeAliases": true,
"referenceId": "onb-req-49210",
"notify": false
}'
Example response
{
"screeningId": "scr_4d1b77",
"status": "complete",
"coverage": ["sanctions", "pep", "adverse_media"],
"createdAt": "2026-01-21T10:03:11Z"
}
GET /screenings: List screenings with filters and summary risk details.
Query parameters
- subjectType: individual | organization
- status: queued | running | complete | error
- coverage: sanctions | pep | adverse_media (comma-separated)
- updatedFrom, updatedTo: ISO 8601 timestamps
- page, pageSize: integers for pagination
Example response
{
"items": [
{
"screeningId": "scr_4d1b77",
"subject": {
"type": "individual",
"primaryName": "Maria Santos",
"dateOfBirth": "1985-09-12"
},
"coverage": ["sanctions", "pep", "adverse_media"],
"status": "complete",
"riskSummary": {
"riskLevel": "medium",
"matchCount": 2,
"sanctionsMatches": 1,
"pepMatches": 1,
"adverseMediaCount": 0
},
"updatedAt": "2026-01-21T10:05:41Z",
"decision": {
"state": "under_review",
"reviewerId": null
}
}
],
"page": 1,
"pageSize": 50,
"total": 1
}
Results & Reports
GET /screenings/{screeningId}/results: Retrieve detailed matches, list sources, confidence, and a downloadable report artifact.
curl --request GET \
--url https://api.supergood.ai/integrations/<integration_id>/screenings/scr_4d1b77/results \
--header 'Authorization: Bearer <authToken>'
Example response
{
"screeningId": "scr_4d1b77",
"matches": [
{
"matchId": "mtc_91a2fe",
"listSource": {
"name": "OFAC SDN",
"jurisdiction": "US"
},
"entityName": "Maria Santos",
"aka": ["Maria T. Santos"],
"listType": "sanctions",
"riskLevel": "high",
"confidence": 0.87,
"country": "US",
"programs": ["Narcotics Trafficking"],
"dateAdded": "2020-03-15",
"lastUpdated": "2025-11-02",
"fuzzyScore": 0.87,
"decision": {
"state": "under_review",
"notes": null
}
},
{
"matchId": "mtc_7bb6c1",
"listSource": {
"name": "PEP Tier 2",
"jurisdiction": "AU"
},
"entityName": "Maria Santos",
"listType": "pep",
"riskLevel": "medium",
"confidence": 0.91,
"country": "AU",
"position": "Local Government Official",
"lastUpdated": "2026-01-10",
"fuzzyScore": 0.91,
"decision": {
"state": "false_positive",
"notes": "Different DOB and jurisdiction"
}
}
],
"report": {
"format": "pdf",
"downloadUrl": "https://api.supergood.ai/downloads/rep_0ca42f.pdf?sig=...",
"expiresAt": "2026-01-22T10:05:41Z",
"checksum": "sha256:3f1e...a90c"
}
}
Monitoring
POST /monitoring/subscriptions: Enroll a subject in ongoing monitoring with coverage and alert preferences.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/monitoring/subscriptions \
--header 'Authorization: Bearer <authToken>' \
--header 'Content-Type: application/json' \
--data '{
"subject": {
"subjectId": "sub_1bf9e0",
"type": "organization",
"primaryName": "Santos Trading Pty Ltd",
"country": "AU"
},
"coverage": ["sanctions", "pep", "adverse_media"],
"frequency": "daily",
"alertDestinations": [{"type": "webhook", "url": "https://yourapp.com/webhooks/namescan"}],
"notifyOn": ["match_added", "risk_level_changed"],
"referenceId": "cust-7731"
}'
Example response
{
"subscriptionId": "mon_a21c90",
"status": "active",
"coverage": ["sanctions", "pep", "adverse_media"],
"createdAt": "2026-01-21T12:44:19Z"
}
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
Performance Characteristics
- 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
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.
Frequently Asked Questions
Q: Which NameScan modules can this integration cover?
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.
Q: How are MFA and SSO handled for automation?
We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. Sessions are refreshed automatically with secure challenge handling.
Q: Are reports and evidence artifacts supported?
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.
Q: Can you set up and manage ongoing monitoring from our product?
Yes. We support creating subscriptions, delivering alerts via webhooks, and updating coverage/jurisdictions to match your risk policies.
Q: How do you handle data source variations and licensing?
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.
Related Integrations
ComplyAdvantage API - Programmatically access AML screening data with Supergood
Ready to automate your NameScan workflows?
Supergood can have your NameScan integration live in days with no ongoing engineering maintenance.
