Skip to content
  • There are no suggestions because the search field is empty.

Run a Bulk Search in Batch Screening

Screening Large Datasets Efficiently

This guide walks you through the Batch Screening process, making it easy to efficiently screen large volumes of entries, up to 9,999 records per file, in a single run.

Screenshot_batch_screening

This feature is perfect for teams that need to perform bulk screenings. All you need to do is:

  1. Prepare your Excel file in the correct format.
  2. Upload it to Batch Screening.
  3. Review your screening results in minutes.

With Batch Screening, you can streamline your compliance checks, reduce repetitive manual work, centralize results in a single file, and ensure consistent results across your entire dataset.

Benefits

High-Volume Screening Without Coding: Process thousands of names at once using the screening template; no technical integration or API coding required.

Screening Against All Enabled Lists: Valid records are screened in a single run against all lists enabled on your account, including sanctions, PEP, and adverse media data.

Detailed Match Review: Review results in the portal by clicking individual records and matches.

Automated Email Notifications: Get an email summary and a download link whenever a batch finishes.

Before you start

  • Accepted formats: .xlsx
  • File limit: 10,000 rows, including the header row; up to 9,999 records.
  • Screening settings: use the template to set a minimum confidence score, target specific watchlists, and specify entity type.
  • Data quality: check your data for accuracy and include optional fields where possible to improve match accuracy.

In this article

→ Download the Screening Template
→ Prepare your Data
→ Upload your Batch File
→ File Validation and Troubleshooting


 

Download the Screening Template

On the Batch Screening page, click Download XLSX template.

Screenshot 2026-10-23 at 15.40.59


 

Prepare your Data

  1. Open the screening template using your preferred spreadsheet software.
  2. Enter your data.
    • Required: min_score, data_source, and name
    • Optional: external_identifier, date_of_birth, country, entity_type, and identifier
  3. Save your file. You can rename it if needed.

Important: Before uploading, make sure your data follows the template's formatting requirements. For detailed instructions, see Screening Template: Prepare and Format your Data.


 

Upload your Batch File

Once your data is prepared, you're ready to run your batch.

  1. On the Batch Screening page, click Upload file.
  2. Select your file, confirm it's the correct one, and upload it.

Valid records are screened against the lists enabled on your account, which may include sanctions, PEP, and adverse media data. Once processing finishes, the batch appears under Recent batches.

Warning: Make sure your file contains no more than 10,000 rows (including headers).


 

File Validation and Troubleshooting

After you upload your file, the system checks that it follows the screening template before processing begins. This includes checking the column headers and validating field values.

A valid record must follow the template, include the required fields (min_score, data_source, and name), and use accepted values.

Find Validation Errors

If validation errors occur, a red exclamation mark appears beside the batch under Recent batches. Hover over it to see the Parsing errors message and affected fields.

Screenshot_batch_names_replaced_2 copy
To review the details:

  1. Download the batch report and extract the ZIP file.
  2. Open a file with parsing-errors in its name, available in Excel (.xlsx) and JSON (.json) formats. These files describe the errors affecting your records.
  3. You can also find the errors in the first rows of the results file.

Understand the Error Messages

Error message What to check

wrong file template

Make sure no column headers have been deleted or reordered, and that the screening template is on the spreadsheet's first tab.
unknown Country UK Replace the unrecognized country value with an accepted value from the formatting guide.
unknown DataSource WATCHLISTS Replace the unrecognized data source with an accepted value from the formatting guide.
Invalid option entered; valid choices are Aircraft, Country, Entity, Individual, Vessel Use one of the entity types listed in the message.
The search query is too long. Please shorten your query and try again Shorten the value in the name field to 15 words or fewer.
Please provide a value for at least one of the following fields: "name", "wallet_address", "address," or "identifier" name or identifier are empty. Enter a value in at least one of these fields.

Correct and re-upload

Correct the affected headers or values. If only some records were not processed, upload only those records, keeping the original template structure and headers.

Note: Every processed record counts toward your screening plan. Re-uploading previously processed records uses additional screenings.


 

Ready to automate your compliance workflow?

Check out the documentation to automate or integrate your screening process seamlessly.


We're here to help

If you have questions or need assistance, our support team is happy to help.