> For the complete documentation index, see [llms.txt](https://docs.complycube.com/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.complycube.com/documentation/product-guides/watchlist-pep-and-adverse-media/bulk-processing.md). # Bulk Processing ### Bulk Processing Overview Bulk Processing (batch processing) lets you **bulk upload customers** and run batch [AML Screening Checks](/documentation/product-guides/watchlist-pep-and-adverse-media/aml-screening-check.md) 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**. {% hint style="info" %} This service has a **soft limit** of **1000 customers** per batch. Get in touch with your **Account Manager** to increase it. {% endhint %} {% hint style="info" %} 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. {% endhint %} ### 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](/documentation/product-guides/watchlist-pep-and-adverse-media/aml-screening-check.md) 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](/documentation/product-guides/watchlist-pep-and-adverse-media/custom-lists.md) to screen against proprietary watchlists. ### Interactive demo {% @arcade/embed url="" flowId="uGwZpFKK1AVvP27Ac2ne" %} ### 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. {% file src="/files/-MdWkumYq45AUdB2-x6U" %} Sample Template {% endfile %} ### 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](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) 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. {% hint style="info" %} If the **address** portion of an entry cannot be processed, the issue is recorded in the **error file** (available on the [Portal](https://portal.complycube.com/batchProcessor)). However, **client creation** and any selected **screening checks** will still proceed. {% endhint %} ### 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.
### Related topics * [AML Screening Check](/documentation/product-guides/watchlist-pep-and-adverse-media/aml-screening-check.md) for sanctions, watchlist, PEP, and adverse media screening. * [Custom Lists](/documentation/product-guides/watchlist-pep-and-adverse-media/custom-lists.md) to extend AML screening with proprietary risk lists. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.complycube.com/documentation/product-guides/watchlist-pep-and-adverse-media/bulk-processing.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.