RiskOS™ supports uploading and evaluating multiple cases at once using a CSV file.

This is especially useful when you want to:

- Run evaluations in bulk for testing or QA
- Migrate data into RiskOS™ from another system
- Process offline applications or events in a single upload

This guide outlines how to properly format and upload a CSV to trigger batch evaluations via the Case Queue.

## Prepare your CSV file for upload

Before uploading your CSV file to RiskOS™, make sure it’s formatted correctly and includes the right fields. This ensures your batch upload runs smoothly and any dependent modules process as expected.

### Basic requirements

Your CSV file must meet the following requirements:

- **Type**: `.CSV`
- **Size**: Maximum file size **5 MB**

### Column formatting

RiskOS™ expects column headers to match our API field structure, which uses JSON-path notation. For example:

- To include a user’s given name, use: `data.individual.given_name`
- To include an email: `data.contact.email`

> 📘  
> **Required Fields**:  
>  - `id` – Unique identifier for each event  
>  - `timestamp` – When the event occurred (must follow this format: YYYY-MM-DDTHH:MM:SS.SSSZ)  
>  
> Additional fields may also be required depending on your use case. For example:  
> - `event_type` and `event_category` are needed for `account_takeover` and `trust_and_safety` workflows  
> - Third-party modules (e.g., Socure enrichment) may have their own required fields  
>  
> If you’re unsure which fields are mandatory, check the [RiskOS™ API Reference](https://help.socure.com/riskos/reference/get-started#/) or contact [support@socure.com](mailto:support@socure.com). Any field required in the API is also required in the CSV.

### Downloadable CSV templates

To help you get started, RiskOS™ provides downloadable CSV templates with the correct formatting:

- [Events Template](https://storage.googleapis.com/files.effectiv.ai/batch_evaluation_upload_templates/sc_event_application_template.csv) (e.g., `trust_and_safety`, `login_authentication`)
- [Business Onboarding Template](https://storage.googleapis.com/files.effectiv.ai/batch_evaluation_upload_templates/sc_business_onb_application_template.csv) (e.g., `business_onboarding`)

### Adding custom fields

RiskOS™ supports custom fields in CSV uploads, with a few limitations:

- Use flat key-value format: e.g., `data.custom.foo,` `data.custom.bar`
- No nested objects — nested structures are only supported via API
- All custom fields are treated as strings by default. If you need specific data types, please reach out to the RiskOS™ team.

## Upload a CSV file

1. Navigate to **All Cases**.
2. Click on **CSV Import** in the upper right corner.
3. On the **CSV Data Import** screen, drag and drop your prepared file or click to browse from your file system.

4. Click **Start Import**. A notification will confirm that the batch is running in the background. You’ll be notified once it’s complete.

## Review the batch upload

Once processing is finished, you’ll receive a notification in the **Notifications** sidebar (click the 🔔 icon in the upper right corner).

The notification will indicate how many rows were processed successfully. You’ll see an option to **Download Result**, which includes error details in case specific rows failed.

## Viewing uploaded cases in Case Management

After the import and processing are completed successfully, the uploaded evaluations will appear based on the workflow outcome in either **All Cases** or a specific queue.