ComplyAdvantage

Supergood | ComplyAdvantage API

Alex Klarfeld

Alex Klarfeld

— 5 min read
Supergood | ComplyAdvantage API

Programmatically access ComplyAdvantage’s AML/KYC datasets—sanctions, PEPs, watchlists, adverse media—and compliance monitoring tools via a stable REST API. Supergood builds and operates production-grade, unofficial ComplyAdvantage integrations so your team can automate risk screening, monitoring, and transaction checks without heavy custom engineering.

ComplyAdvantage is software that helps financial institutions and fintechs detect and prevent financial crime. With an unofficial API, you can automate subject screening against global sanctions and PEP lists, retrieve adverse media signals, subscribe customers to ongoing monitoring, and ingest alerts—directly inside your onboarding and compliance pipelines.

If you’re a tech company integrating ComplyAdvantage, you can push customer profiles for screening, pull normalized watchlist hits and risk scores, enable continuous monitoring, and route results to case queues. You can also enrich identities, trigger transaction checks, and export evidence for audit trails—reducing manual work while maintaining strong regulatory coverage.

What is ComplyAdvantage?

ComplyAdvantage is a RegTech provider focused on financial crime risk data and compliance workflow automation. Its platform powers KYC/AML screening, sanctions and PEP checks, adverse media detection, transaction monitoring, and ongoing watchlist updates.

Core product families include:

  • Screening and Monitoring (sanctions/PEP/adverse media/watchlists)
  • Transaction Monitoring (rules-based detection, alerts, cases)
  • Customer Risk Assessment (risk scoring, profiles, ongoing oversight)
  • Compliance Operations (case management, audit and reporting)

Common data entities:

  • Subjects (persons and organizations)
  • Screenings and monitoring subscriptions
  • Watchlist hits (sanctions, PEP, enforcement, adverse media)
  • Alerts and cases (transaction rules, watchlist updates)
  • Reports and audit artifacts

The ComplyAdvantage Integration Challenge

Organizations rely on ComplyAdvantage daily, but turning portal-centric workflows into automated pipelines is challenging:

  • Product entitlements and licensing: Access differs across screening, monitoring, and transaction tools
  • Enterprise security controls: SSO, MFA, and network restrictions complicate headless automation
  • Portal-first experiences: Key capabilities live in the web app; public APIs may be limited or vary by account
  • Data timeliness and normalization: Watchlist updates, adverse media coverage, and risk scoring need consistent schemas

How Supergood Creates ComplyAdvantage APIs

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

  • 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 capabilities
  • Aligns with customer entitlements and licensing constraints to ensure compliant access

Use Cases

KYC/AML Screening Automation

  • Trigger person or company screenings during onboarding
  • Retrieve sanctions/PEP/adverse media hits with normalized risk scores
  • Auto-route outcomes to approval, review, or decline queues

Continuous Watchlist Monitoring

  • Subscribe subjects to ongoing monitoring
  • Receive alerts when sanctions or PEP status changes
  • Track adverse media changes and remediate in case systems

Transaction Monitoring Orchestration

  • Screen payments and counterparties for sanctions exposure
  • Apply rules and risk thresholds to flag suspicious activity
  • Centralize alerts and evidence for investigation

Compliance Archival and Audit Trails

  • Export complete screening packets with metadata and hit rationales
  • Timestamp artifacts for auditability and regulatory retention
  • Prove coverage with consistent, machine-readable evidence

Available Endpoints

Authentication

POST /auth/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>/auth/sessions \
  --header 'Authorization: Basic <Base64 encoded token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "username": "[email protected]",
    "password": "<password>",
    "mfa": { "type": "totp", "code": "123456" },
    "ssoProvider": null
  }'

Example response

{
  "authToken": "eyJhbGciOi...",
  "expiresIn": 3600,
  "user": {
    "id": "u_5c18e9",
    "name": "Analyst One",
    "entitlements": ["screening", "monitoring", "alerts"]
  }
}

POST /auth/sessions/refresh: Refresh an existing token to keep sessions uninterrupted.

Subjects

POST /subjects: Create or upsert a subject profile (person or company) to be used for screening and monitoring.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/subjects \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "subjectType": "person",
    "names": {"first": "Alex", "middle": null, "last": "Rivera"},
    "birthDate": "1987-07-14",
    "countryCodes": ["US"],
    "addresses": [{
      "line1": "101 Market St",
      "city": "San Francisco",
      "region": "CA",
      "postalCode": "94105",
      "country": "US"
    }],
    "idNumbers": {
      "nationalId": null,
      "passport": null,
      "taxId": "123-45-6789"
    },
    "aliases": ["A. Rivera"],
    "referenceId": "cust-8821"
  }'

Example response

{
  "subjectId": "sub_9f21a7",
  "subjectType": "person",
  "createdAt": "2026-01-19T15:21:09Z",
  "referenceId": "cust-8821"
}

Screenings

POST /screenings: Run a sanctions/PEP/adverse media screening for a subject. Optionally configure monitoring.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/screenings \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "subjectId": "sub_9f21a7",
    "watchlistScope": {
      "sanctions": true,
      "pep": true,
      "regulatoryEnforcements": true,
      "stateOwnedEntities": false
    },
    "adverseMediaCategories": ["financial_crime", "fraud"],
    "riskThreshold": 70,
    "monitoring": { "enabled": true, "frequency": "daily" },
    "referenceId": "onboarding-req-8821"
  }'

Example response

{
  "screeningId": "scr_45b8a2",
  "status": "running",
  "createdAt": "2026-01-19T15:21:09Z",
  "referenceId": "onboarding-req-8821"
}

GET /screenings/{screeningId}/results: Retrieve normalized results for a completed screening, including matched entities, risk scoring, and evidence links.

curl --request GET \
  --url https://api.supergood.ai/integrations/<integration_id>/screenings/scr_45b8a2/results \
  --header 'Authorization: Bearer <authToken>'

Example response

{
  "screeningId": "scr_45b8a2",
  "status": "complete",
  "subjectSummary": {
    "name": "Alex Rivera",
    "subjectType": "person",
    "referenceId": "onboarding-req-8821"
  },
  "riskScore": 64,
  "hits": [
    {
      "hitId": "hit_san_001",
      "type": "sanctions",
      "list": "OFAC SDN",
      "entityName": "Alex R. Rivera",
      "matchScore": 86,
      "country": "US",
      "evidence": {
        "sourceUrl": "https://ofac.example/entry/1234",
        "snippet": "Name and alias similarity"
      }
    },
    {
      "hitId": "hit_pep_003",
      "type": "pep",
      "entityName": "Alexander Rivera",
      "position": "Municipal Official",
      "matchScore": 72,
      "evidence": {
        "sourceUrl": "https://pep.example/profile/8721",
        "snippet": "Alias matched with public position"
      }
    }
  ],
  "adverseMedia": {
    "items": [
      {
        "articleId": "am_992",
        "title": "Investigation into procurement irregularities",
        "publisher": "City News",
        "publishedAt": "2026-01-18T12:00:00Z",
        "category": "financial_crime",
        "relevance": 0.74
      }
    ]
  },
  "monitoring": { "enabled": true, "lastRunAt": "2026-01-19T16:03:11Z" },
  "summary": {
    "sanctions": 1,
    "pep": 1,
    "adverseMedia": 1,
    "regulatoryEnforcements": 0
  }
}

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
  • Rate limits: Tuned for enterprise throughput while honoring licensing and usage controls
  • Session management: Automatic reauth and cookie/session rotation with health checks
  • Data freshness: Near real-time retrieval of screenings, hits, and generated reports
  • Security: Encrypted transport, scoped tokens, and audit logging; respects ComplyAdvantage entitlements
  • Webhooks: Optional asynchronous delivery for long-running screenings and monitoring alerts

Performance Characteristics

  • Latency: Sub-second responses for list/detail queries under normal load
  • Throughput: Designed for high-volume onboarding and batch screening pipelines
  • 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 product mix, licensing, and authentication model.

  1. Supergood Builds and Validates Your API

We deliver a hardened ComplyAdvantage adapter tailored to your workflows and entitlements.

  1. Deploy with Monitoring

Go live with continuous monitoring and automatic adjustments as ComplyAdvantage evolves.

Schedule Integration Call →

Frequently Asked Questions

Q: Which ComplyAdvantage products can this integration cover?

Supergood supports workflows across screening, monitoring, and transaction monitoring, 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: Can I enable continuous monitoring for screened subjects?

Yes. You can toggle monitoring at creation or later, and receive updates via webhooks or polling endpoints while complying with rate and licensing constraints.

Q: How do you normalize watchlist hits and adverse media?

We standardize hit types, match scores, source metadata, and risk summaries into consistent objects so your downstream systems don’t need to handle source-specific schemas.

Dow Jones Risk & Compliance API - Programmatically access Dow Jones Risk & Compliance with Supergood

Ready to automate your ComplyAdvantage workflows?

Supergood can have your ComplyAdvantage integration live in days with no ongoing engineering maintenance.

Get Started →

Read more