Supergood | Refinitiv World-Check API

Supergood | Refinitiv World-Check API

Programmatically screen individuals and organizations against PEP, sanctions, and adverse media watchlists—plus manage ongoing monitoring and adjudication workflows—with a stable REST API. Supergood builds and operates production-grade, unofficial Refinitiv World-Check integrations so your team can embed AML/KYC screening and monitoring without heavy custom engineering.

Plain English: Refinitiv World-Check is a risk intelligence database used by banks, fintechs, and regulated companies to screen customers and counterparties for AML/KYC risk. An unofficial API lets you programmatically submit people or companies for screening, retrieve match candidates and risk categories (PEP, sanctions, law enforcement, adverse media), record decisions (false positive vs. positive match), and subscribe subjects to ongoing monitoring.

For a tech company integrating with Refinitiv World-Check, this means you can pull match results and source references into onboarding flows, push adjudication decisions back to keep cases in sync, automate alert ingestion for monitoring, and enrich your product with risk badges, audit trails, and screening reports. You can also normalize subjects across jurisdictions, reduce false positives with custom profiles, and keep your CRM, case management, and analytics systems aligned.

What is Refinitiv World-Check?

Refinitiv World-Check (https://www.lseg.com/) is a global risk intelligence solution from LSEG used to identify, assess, and monitor financial crime risk. It aggregates and curates data on politically exposed persons (PEPs), sanctions lists, regulatory and law enforcement actions, state-owned enterprises, and structured adverse media to support AML/KYC, sanctions compliance, and third-party risk programs. The browser-based product (often accessed via World-Check One) supports one-off, batch, and ongoing screening with case management and audit features.

Core product areas include:

  • AML/KYC Screening (individuals and organizations)
  • PEP and Sanctions Screening (global lists and programs)
  • Adverse Media and Enforcement Actions (structured categories)
  • Ongoing Monitoring (alerts when profiles or lists change)
  • Case Management & Dispositioning (review, notes, attachments)
  • Screening Profiles & Risk Policies (thresholds, categories, locales)

Common data entities:

  • Subjects (Individuals, Organizations) with identifiers and demographics
  • Screenings (input parameters, results, timestamps)
  • Matches (candidate profiles with scores, categories, and sources)
  • Alerts (monitoring events: new matches, profile changes, list updates)
  • Decisions/Adjudications (disposition, risk rating, reasons, audit)
  • Screening Profiles/Policies (match thresholds, categories, localization)
  • Custom Lists/Overrides (internal watchlist entries, exclusions)

The Refinitiv World-Check Integration Challenge

Compliance teams rely on World-Check daily, but turning portal-based workflows into API-driven automation is non-trivial:

  • Fuzzy matching and multilingual names: transliteration, aliases, and partial data
  • Complex profiles and thresholds: jurisdictional nuances and category scopes
  • High-stakes data handling: PII security, audit trails, and entitlements
  • Ongoing monitoring: alert ingestion, deduplication, and SLA-driven triage
  • Adverse media normalization: structured topics, severity, and sources
  • Authentication complexity: SSO/MFA and session lifecycles for headless use
  • Rate limits and batching: large-scale onboarding and periodic rescreening

How Supergood Creates Refinitiv World-Check APIs

Supergood reverse-engineers authenticated browser flows and network interactions to deliver a resilient API endpoint layer for your World-Check tenant.

  • Handles username/password, SSO/OAuth, and MFA (SMS, email, TOTP) securely
  • Maintains session continuity with automated refresh and change detection
  • Normalizes matches and categories (PEP, sanctions, enforcement, adverse media) with consistent schemas
  • Respects entitlements, access scopes, and approval workflows for compliant access
  • Provides audit-friendly logging and redaction for PII

Use Cases

Onboarding Screening

  • Screen applicants and counterparties in real time during signup or KYC refresh
  • Standardize subject payloads across business units and geographies
  • Return normalized match candidates with risk categories and source references

Ongoing Monitoring & Alert Triage

  • Subscribe customers to monitoring and ingest alerts when lists or profiles update
  • Route alerts by severity or category and track acknowledgments
  • Sync alert states into your case management system

Case Adjudication & Evidence Sync

  • Record decisions (positive match, false positive) with reasons and attachments
  • Keep dispositions and risk ratings in sync across internal tools
  • Generate audit-ready logs and exportable reports

Portfolio Rescreening & Analytics

  • Run periodic rescreens across books of business with batching and throttling
  • Normalize categories and scores for risk dashboards
  • Enrich 360° customer views with PEP/sanctions/adverse media badges

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_wc_0a92f3",
    "name": "Compliance Analyst",
    "entitlements": ["screenings", "matches", "decisions", "alerts"]
  }
}

Screenings

POST /screenings: Submit a person or company for screening with identifiers and policy options.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/screenings \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "subject": {
      "subjectType": "individual",
      "givenNames": ["Aleksandr"],
      "familyName": "Ivanov",
      "aliases": ["Alexander Ivanov"],
      "dateOfBirth": "1982-03-15",
      "nationalities": ["RU"],
      "residencyCountries": ["DE"],
      "identifiers": [
        {"type": "passport", "value": "53XXXXXXX", "country": "RU"}
      ],
      "addresses": [
        {"line1": "Hauptstrasse 12", "city": "Berlin", "postalCode": "10115", "country": "DE"}
      ]
    },
    "screeningOptions": {
      "screeningProfileId": "prof_eu_standard",
      "categories": ["pep", "sanctions", "law_enforcement", "adverse_media"],
      "matchThreshold": 85,
      "fuzzy": true,
      "languages": ["en", "ru", "de"]
    },
    "referenceId": "onb-req-219847"
  }'

Example response

{
  "screeningId": "scrn_71f3b2",
  "status": "processing",
  "submittedAt": "2026-01-21T10:03:11Z",
  "screeningProfileId": "prof_eu_standard",
  "summary": {
    "totalCandidates": 0,
    "byCategory": {"pep": 0, "sanctions": 0, "law_enforcement": 0, "adverse_media": 0}
  }
}

Matches

GET /screenings/{screeningId}/matches: Retrieve match candidates with normalized scores, categories, and source references.

Query parameters

  • minScore: integer (0–100)
  • categories: comma-separated list (pep, sanctions, law_enforcement, adverse_media)
  • status: unresolved | resolved
  • page, pageSize: integers for pagination

Example response

{
  "items": [
    {
      "matchId": "mtch_b0c819",
      "entityId": "wc_ent_998172",
      "entityType": "person",
      "name": "Aleksandr Ivanov",
      "aliases": ["Alexander Ivanov"],
      "categories": ["pep"],
      "score": 92,
      "matchStrength": "strong",
      "matchedFields": {"name": ["Aleksandr Ivanov"], "dateOfBirth": ["1982-03-15"], "nationality": ["RU"]},
      "countries": ["RU", "DE"],
      "dateOfBirths": ["1982-03-15"],
      "sanctionsPrograms": [],
      "sourceReferences": [
        {"dataset": "PEP", "sourceId": "pep-ru-tier2-12345", "url": "https://...", "lastUpdated": "2026-01-15"}
      ],
      "lastUpdated": "2026-01-21T10:05:44Z",
      "status": "unresolved"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Decisions

PATCH /screenings/{screeningId}/decision: Record adjudication for a screening and persist compliance context.

curl --request PATCH \
  --url https://api.supergood.ai/integrations/<integration_id>/screenings/scrn_71f3b2/decision \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "disposition": "false_positive",
    "riskRating": "low",
    "reasonCodes": ["name_mismatch", "dob_mismatch"],
    "notes": "Candidate is a different person with same name; identifiers and DOB do not match.",
    "attachments": [
      {"fileName": "passport_check.pdf", "uploadToken": "upl_0db3a9"}
    ],
    "nextReviewAt": "2027-01-21T00:00:00Z"
  }'

Example response

{
  "decisionId": "dcs_4a1107",
  "screeningId": "scrn_71f3b2",
  "disposition": "false_positive",
  "riskRating": "low",
  "decidedAt": "2026-01-21T11:20:44Z",
  "decidedBy": {"id": "u_wc_0a92f3", "name": "Compliance Analyst"}
}

Alerts

GET /alerts: List monitoring alerts across subscribed subjects with filters for severity and category.

Query parameters

  • status: open | acknowledged | closed
  • severity: low | medium | high
  • category: pep | sanctions | law_enforcement | adverse_media
  • updatedFrom, updatedTo: ISO 8601 timestamps
  • page, pageSize: integers for pagination

Example response

{
  "items": [
    {
      "alertId": "alrt_8f6d90",
      "type": "sanctions_change",
      "category": "sanctions",
      "severity": "high",
      "screeningId": "scrn_71f3b2",
      "monitoringSubscriptionId": "mon_24b8aa",
      "subjectRef": {
        "subjectType": "individual",
        "name": "Aleksandr Ivanov",
        "referenceId": "onb-req-219847"
      },
      "currentDecision": {"disposition": "false_positive", "riskRating": "low"},
      "createdAt": "2026-03-10T08:25:10Z",
      "updatedAt": "2026-03-10T08:25:10Z",
      "status": "open"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Get full API Specs →


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 onboarding/monitoring throughput while honoring entitlements and usage controls
  • Session management: Automatic reauth and cookie/session rotation with health checks
  • Data freshness: Near real-time retrieval of screenings, matches, and alerts
  • Security: Encrypted transport, scoped tokens, field-level redaction, and audit logging; respects role-based permissions and data residency requirements
  • Webhooks: Optional asynchronous delivery for long-running workflows and monitoring alerts

Performance Characteristics

  • Latency: Sub-second responses for list/detail queries under normal load
  • Throughput: Designed for high-volume batch screening 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

  1. Schedule Integration Assessment

Book a 30-minute session to confirm your modules, licensing, and authentication model.

  1. Supergood Builds and Validates Your API

We deliver a hardened World-Check adapter tailored to your workflows and entitlements.

  1. Deploy with Monitoring

Go live with continuous monitoring and automatic adjustments as World-Check evolves.

Schedule Integration Call →


Frequently Asked Questions

Q: Which World-Check modules can this integration cover?

Supergood supports workflows such as AML/KYC screening (individuals, organizations), PEP/sanctions/adverse media matches, ongoing monitoring alerts, and case adjudication—subject to your licensing and entitlements. We scope exact 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 and audit logging.

Q: Can you push adjudication decisions and sync alert states to our case system?

Yes. We normalize dispositions, risk ratings, and reason codes, and can deliver state changes via webhooks or polling. We commonly sync with internal case tools, CRMs, and GRC systems.

Q: How do you manage PII securely?

We minimize data in transit, encrypt at rest and in motion, support field-level redaction, and maintain audit trails. We align with customer data residency and retention policies.

Q: Do you support ongoing monitoring and portfolio rescreening?

Yes. We can enable monitoring subscriptions, ingest alerts with severity/category filters, and orchestrate periodic rescreens with batching and throttling.


Dow Jones Risk & Compliance API - Programmatically access watchlist and adverse media data with Supergood


Ready to automate your Refinitiv World-Check workflows?

Supergood can have your World-Check integration live in days with no ongoing engineering maintenance.

Get Started →

Read more