---
title: "Get the states for all batch processes"
method: GET
path: "/v2/batch-processing"
tags: ["Batch Processing"]
---

# Get the states for all batch processes

`GET /v2/batch-processing`

This endpoint will return a list of all batch processes that have been initiated, including their `identifiers`, status and errors.


You need one of the "View customers" or "View transactions" permissions to use this endpoint.

## Query parameters

- `page_number` integer
- `page_size` integer
- `sort` string[]
- `status` string[]
- `created_by` string[]
- `workflow_type` 'create-and-screen' | 'create-and-monitor' | 'manage-lookup-list', required — The workflow type for the batch process
- `target_identifier` string, uuid

## Response `200`

OK

- BulkPaginatedResponseBatch
  - `batches` BulkBatch[], required
    - `account_identifier` string, uuid, required
    - `created_at` string, date-time, required
    - `created_by` string, uuid, nullable
    - `errors` BulkBatchErrors
      - `file_errors` BulkFileError[], required
        - `attributes` BulkErrorAttributes
          - `affected_rows` integer[], required
          - `column_names` string[], required
          - `column_options` array[], required
            - string[]
          - `expected_range` integer[], required
          - `max_row_limit` integer, nullable
          - `rejected_values` string[], required
          - `required_format` string, required
          - `required_formats` string[], required
        - `code` 'UNSUPPORTED_MIMETYPE' | 'MULTIPLE_SHEETS_FOUND' | 'MALFORMED_CONTENT' | 'UNSUPPORTED_COLUMN' | 'MAX_ROW_LIMIT_EXCEEDED' | 'INVALID_CUSTOM_LIST_IDENTIFIER' | 'INVALID_LOOKUP_LIST_IDENTIFIER' | 'INVALID_LOOKUP_LIST_STATUS', required
      - `reason` 'INTERNAL_ERROR' | 'MALFORMED_FILE' | 'INVALID_ROWS' | 'INVALID_SEQUENCE_KEY', nullable
      - `row_errors` BulkRowError[], required
        - `errors` BulkRowErrorMessage[], required
          - `attributes` BulkErrorAttributes
            - `affected_rows` integer[], required
            - `column_names` string[], required
            - `column_options` array[], required
              - …
            - `expected_range` integer[], required
            - `max_row_limit` integer, nullable
            - `rejected_values` string[], required
            - `required_format` string, required
            - `required_formats` string[], required
          - `code` 'MANDATORY_COLUMN_MISSING' | 'ONE_OF_REQUIRED' | 'MUTUALLY_EXCLUSIVE' | 'INVALID_RESIDENTIAL_STATUS' | 'INVALID_CURRENCY_CODE' | 'INVALID_COUNTRY_CODE' | 'INVALID_COUNTRY_SUBDIVISION_CODE' | 'INVALID_IDENTIFIER' | 'INVALID_NUMBER' | 'INVALID_BIRTH_DATE_YEAR' | 'INVALID_PHONE_NUMBER' | 'INVALID_EMAIL_ADDRESS' | 'INVALID_URL' | 'INVALID_GENDER' | 'INVALID_COMPANY_STATUS' | 'INVALID_ADDRESS_TYPE' | 'INVALID_ADDRESS_TYPE_PERSON' | 'INVALID_ADDRESS_TYPE_COMPANY' | 'INVALID_PERSONAL_IDENTIFICATION_TYPE' | 'CUSTOMER_LABEL_NOT_FOUND' | 'SCREENING_CONFIGURATION_NOT_FOUND' | 'MAX_SIZE_LIMIT_REACHED' | 'MIN_SIZE_LIMIT_REACHED' | 'INVALID_IBAN' | 'INVALID_IP_ADDRESS' | 'INVALID_DATE' | 'DATE_NOT_IN_PAST' | 'DATE_EXCEEDS_PRESENT' | 'INVALID_DATE_OF_EXPIRY' | 'INVALID_SALARY_AMOUNT' | 'INVALID_SALARY_CURRENCY' | 'INVALID_BIC' | 'INVALID_CHARACTER' | 'INVALID_BOOLEAN' | 'INVALID_TIMESTAMP' | 'INVALID_TRANSACTION_TYPE' | 'INVALID_TRANSACTION_CLASSIFICATION' | 'INVALID_BANK_PAYMENT_STATE' | 'INVALID_CARD_PAYMENT_STAGE' | 'INVALID_CARD_SCHEME' | 'INVALID_CARD_PAYMENT_SCOPE' | 'INVALID_BANK_IDENTIFICATION_NUMBER' | 'TOO_MANY_CUSTOM_FIELDS' | 'INVALID_PAYMENT_SCHEME' | 'INVALID_PAYMENT_CHANNEL' | 'INVALID_REMITTANCE_PAYMENT_METHOD' | 'INVALID_REMITTANCE_RELATIONSHIP' | 'INVALID_REMITTANCE_PURPOSE' | 'INVALID_REMITTANCE_SOURCE_OF_FUNDS' | 'INVALID_REMITTANCE_SERVICE_PROVIDER_TYPE' | 'INVALID_BLOCKCHAIN_NETWORK_TYPE' | 'INVALID_CASH_PICKUP_METHOD_MISMATCH' | 'INVALID_CARD_VERIFICATION_RESULT' | 'TOO_MANY_AGENTS' | 'INVALID_AGENT_ROLE' | 'INVALID_SCENARIO_CONFIGURATION_IDENTIFIER' | 'TOO_MANY_SCENARIO_CONFIGURATION_IDENTIFIERS' | 'INVALID_CUSTOMER_EXTERNAL_IDENTIFIER' | 'MULTIPLE_CUSTOMERS' | 'CUSTOMER_EXTERNAL_IDENTIFIER_MISMATCH' | 'MIXED_CUSTOMER_DATA_TYPES' | 'CARD_PARTY_CUSTOMER_IDENTIFIER_MISMATCH' | 'INVALID_CARD_PAYMENT_TYPE' | 'INVALID_POS_CONDITION_CODE' | 'INVALID_POS_ENTRY_MODE_CODE' | 'INVALID_CARD_WALLET_TYPE' | 'INVALID_ALPHANUMERIC_VALUE' | 'INVALID_CARD_FUNDING_TYPE' | 'INVALID_MERCHANT_CATEGORY_TYPE' | 'INVALID_MERCHANT_CATEGORY_CODE' | 'INVALID_CARD_CHARGEBACK_OUTCOME' | 'INVALID_CARD_AUTHORIZATION_RESPONSE_CODE' | 'INVALID_CARD_AUTHORIZATION_STATE' | 'INVALID_CARD_AUTHORIZATION_TYPE' | 'CUSTOM_LIST_NOT_FOUND' | 'CUSTOM_LIST_IDENTIFIER_MISMATCH' | 'COUNTERPARTY_NOT_ALLOWED_ON_ULTIMATE_PARTY' | 'INVALID_CAIP_2_IDENTIFIER' | 'INVALID_CAIP_19_IDENTIFIER' | 'INVALID_LATITUDE' | 'INVALID_LONGITUDE' | 'INVALID_LOAN_TYPE' | 'INVALID_CLEARING_IDENTIFIER_TYPE' | 'INVALID_FINCEN_CASH_TRANSACTION_SUBTYPE', required
        - `row_number` integer, required
    - `identifier` string, uuid, required
    - `request` BulkBatchRequest, required
      - `file_name` string, required
      - `upload_method` 'HTTP' | 'SFTP', required
      - `workflow_type` 'create-and-screen' | 'create-and-monitor' | 'manage-lookup-list', required
    - `statistics` BulkBatchStatistics
      - `num_of_completed_workflows` integer, required
      - `num_of_created_workflows` integer, required
      - `num_of_errored_workflows` integer, required
      - `num_of_processed_rows` integer, required
      - `num_of_validated_rows` integer, required
    - `status` 'NOT_STARTED' | 'VALIDATING' | 'VALIDATING_ERROR' | 'PROCESSING' | 'PROCESSING_ERROR' | 'COMPLETED' | 'INTERNAL_ERROR', required
    - `updated_at` string, date-time, required
  - `first` string, required — The URL path to the first page.
  - `next` string, nullable — The URL path to the next page.
  - `prev` string, nullable — The URL path to the previous page.
  - `self` string, required — The URL path to the current page.
  - `total_count` integer, nullable — Total number of items.

---

[API](https://skmtc.dev/complyadvantage/apis/mesh-api.md) · [All operations](https://skmtc.dev/complyadvantage/apis/mesh-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/complyadvantage/mesh-api/revisions/fdaac4351d85/schema)