For the complete documentation index, see llms.txt. This page is also available as Markdown.

Bulk Processing

Bulk AML screening for KYC and KYB. Upload CSV files to screen sanctions, watchlists, PEP, and adverse media at scale.

Bulk Processing Overview

Bulk Processing (batch processing) lets you bulk upload customers and run batch AML Screening Checks in the ComplyCube Portal.

It’s a no-code solution designed for businesses of all sizes. Use it to import large client datasets into ComplyCube via CSV upload, whether for migration purposes or to run periodic batch AML screenings with continuous monitoring.

This service has a soft limit of 1000 customers per batch. Get in touch with your Account Manager to increase it.

ComplyCube is also capable of processing files in bulk through Secure File Transfer Protocol (SFTP). Get in touch with your Account Manager to enable this method.

Common use cases

Use Bulk Processing when you need to run compliance checks across a large dataset:

  • Customer migration: Upload existing customers from another system during migration.

  • Audit & remediation runs: Run a bulk AML screening check to validate or remediate a large set of customers after data corrections, rule changes, or an internal audit.

  • Periodic batch screenings: Upload customer files as part of scheduled internal processes, such as recurring screening reviews, control checks, or compliance refresh cycles.

  • Internal list matching: Combine with Custom Lists to screen against proprietary watchlists.

Interactive demo

spinner

CSV template

Use the CSV template to ensure your bulk upload parses correctly:

  1. Download the bulk upload sample template below.

  2. Open it in Excel, Numbers, or any compatible spreadsheet editor.

  3. Keep the first row unchanged, it contains the required column headers needed for correct parsing.

  4. Enter your data into the relevant columns.

  5. Save the file once complete.

  6. Upload it through the Portal.

Sample Template

CSV formatting requirements

Use these requirements to avoid parsing issues during upload:

  • Keep the template structure unchanged and do not rename or remove required headers.

  • Always include the type, email, and either first name plus last name for individuals or name for companies.

  • Use 2-letter ISO country codes for nationality, address country, and incorporation country values, for example GB, US, or FR.

  • Use YYYY-MM-DD for date of birth values.

  • If you include an address, always include the line, city, and country to avoid parsing errors.

If the address portion of an entry cannot be processed, the issue is recorded in the error file (available on the Portal). However, client creation and any selected screening checks will still proceed.

Best practices

Use these practices to help your uploads run smoothly:

  • Include stronger identifiers like date of birth, nationality, or registration number where possible.

  • Remove duplicate records before upload to reduce duplicate clients and repeated screening results.

  • Review the error file after each batch run and correct any flagged records before the next run.

  • Test with a small batch first to confirm your data maps correctly.

  • Run bulk processing jobs outside your peak usage windows.

Frequently asked questions

When should I use Bulk Processing instead of the API?

Use Bulk Processing when you already have customer data in a CSV file or need a manual or periodic screening run.

Use the API when you need real-time, fully automated screening inside your own systems.

What customer data improves match quality in a bulk screening file?

For individuals, add fields like date of birth, nationality, and country where possible.

Use YYYY-MM-DD for date of birth values.

Use 2-letter ISO country codes for nationality and address country values, for example GB, US, or FR.

For businesses, include registered name, registration number, and incorporation country.

Use a 2-letter ISO country code for incorporation country values, for example GB, US, or FR.

If you provide client details, include the type, email, and either first name plus last name for individuals or name for companies.

If you provide an address, include the line, city, and country to reduce parsing errors.

More identifying data helps reduce weak matches and improves screening quality.

Can the same batch include both individuals and businesses?

Yes.

Bulk Processing supports KYC and KYB screening use cases.

Make sure each record follows the sample template and contains the right fields for the entity type you are uploading.

Can I rerun screening after fixing customer data?

Yes.

Bulk Processing is well suited to remediation and data correction exercises.

After you fix the source data, upload a new batch to rerun screening across the affected customers.

Do I need extra setup for automated bulk file transfers?

Yes.

SFTP is available for automated bulk file delivery, but it must be enabled first.

Contact your Account Manager if you want to set up scheduled file transfers.

  • AML Screening Check for sanctions, watchlist, PEP, and adverse media screening.

  • Custom Lists to extend AML screening with proprietary risk lists.