---
title: "Get list of cases"
method: GET
path: "/v2/cases"
tags: ["Cases"]
---

# Get list of cases

`GET /v2/cases`

Returns a paginated list of cases for the user's account. Accepts filter and sort query parameters.


You need one of the "View cases (customer onboarding)", "View cases (customer monitoring)", "View cases (payment screening)" or "View cases (transaction monitoring)" permissions to use this endpoint.

## Query parameters

- `assignee` string[]
- `assignee_identifier` string[]
- `type` string[]
- `created_at_from` string, date-time
- `created_at_to` string, date-time
- `customer.identifier` string[]
- `customer.risk_level` string[]
- `customer.label` string[]
- `customer.acquisition_source` string[]
- `search` string
- `state` string[]
- `stage.identifier` string[]
- `risk_type` string[]
- `alerts.title` string[]
- `alerts.highest_priority` integer[]
- `risk_catalog_risk_types.key` string[]
- `page_number` integer
- `page_size` integer
- `sort` string[]

## Response `200`

OK

- CaseManagementPaginatedResponseCaseResultResponse
  - `cases` CaseManagementCaseResultResponse[], required
    - `alerts` CaseManagementAlertsSummary, required — Summary of alerts information, including the highest priority.
      - `count` integer, required
      - `highest_priority` integer, nullable, required — The highest priority of alerts associated with the case. Alerts priority: 1-3 -> High 4-6 -> Medium 7-9 -> Low `null` -> No priority
    - `assignee` string, uuid, nullable — User identifier that is currently assigned to case. null if un-assigned.
    - `created_at` string, date-time, required — Case created date and time.
    - `customer` CaseManagementCaseCustomerSummaryResponse — Customer summary that is associated to a case.
      - `acquisition_source` string, nullable — Customer acquisition source.
      - `external_identifier` string, nullable — Customer external identifier.
      - `identifier` string, uuid, required — Customer unique identifier.
      - `name` string, required — Customer name.
      - `risk_level` 'LOW' | 'MEDIUM' | 'HIGH' | 'PROHIBITED' | 'SKIPPED', required — Customer current risk level.
      - `type` 'PERSON' | 'COMPANY' | 'VESSEL' | 'UNDEFINED', required — Customer type.
      - `version` integer, required — Customer version.
    - `identifier` string, uuid, required — Case unique identifier.
    - `last_user_stage` CaseManagementStage, required — Stage
      - `decision_type` 'POSITIVE' | 'NEGATIVE' | 'PARTIAL_POSITIVE', nullable — The decision type of the stage (decision stages only).
      - `display_name` string, required — The display name of the stage.
      - `display_order` integer, required — The display order of the stage.
      - `identifier` string, uuid, required — Stage unique identifier.
      - `stage_type` 'INITIAL' | 'REVIEW' | 'DECISION', required — The type of the stage.
    - `last_user_state` 'ONBOARDING_NOT_STARTED' | 'ONBOARDING_IN_PROGRESS' | 'ONBOARDING_ESCALATED' | 'ONBOARDING_BLOCKED' | 'ONBOARDING_POSITIVE_END_STATE' | 'ONBOARDING_MANAGEABLE_RISK_POSITIVE_END_STATE' | 'ONBOARDING_NEGATIVE_END_STATE' | 'MONITORING_NOT_STARTED' | 'MONITORING_IN_PROGRESS' | 'MONITORING_ESCALATED' | 'MONITORING_BLOCKED' | 'MONITORING_NO_RISK_DETECTED_POSITIVE_END_STATE' | 'MONITORING_RISK_DETECTED_POSITIVE_END_STATE' | 'MONITORING_RISK_DETECTED_NEGATIVE_END_STATE' | 'PAYMENT_SCREENING_NOT_STARTED' | 'PAYMENT_SCREENING_IN_PROGRESS' | 'PAYMENT_SCREENING_ESCALATED' | 'PAYMENT_SCREENING_BLOCKED' | 'PAYMENT_SCREENING_AWAITING_INFORMATION' | 'PAYMENT_SCREENING_PROCESS_PAYMENT_END_STATE' | 'PAYMENT_SCREENING_REJECT_PAYMENT_END_STATE' | 'TRANSACTION_MONITORING_NOT_STARTED' | 'TRANSACTION_MONITORING_IN_PROGRESS' | 'TRANSACTION_MONITORING_ESCALATED' | 'TRANSACTION_MONITORING_BLOCKED' | 'TRANSACTION_MONITORING_ACCEPTED_POSITIVE_END_STATE' | 'TRANSACTION_MONITORING_ESCALATED_NEGATIVE_END_STATE' | 'USER_DEFINED', nullable — The last state the case was transitioned to by a user (as opposed to a system action). For those using the deprecated case_state, if any new case stages are added the case state response for these will be returned as USER_DEFINED
    - `payment` union, required — Summary of payment information.
      - object — Summary of a Bank Payment.
        - `external_identifier` string, required — Payment external identifier.
        - `identifier` string, uuid, required — Payment unique identifier.
        - `type` 'BANK_PAYMENT', required — Payment type.
      - object — Summary of a Card Payment.
        - `external_identifier` string, required — Payment external identifier.
        - `identifier` string, uuid, required — Payment unique identifier.
        - `type` 'CARD_PAYMENT', required — Payment type.
      - object — Summary of a Remittance Payment.
        - `external_identifier` string, required — Payment external identifier.
        - `identifier` string, uuid, required — Payment unique identifier.
        - `type` 'REMITTANCE', required — Payment type.
      - object — Summary of a Crypto Payment.
        - `external_identifier` string, required — Payment external identifier.
        - `identifier` string, uuid, required — Payment unique identifier.
        - `type` 'CRYPTO', required — Payment type.
    - `review_items_count` integer, required — Number of items to review in case.
    - `risk_catalog_risk_types` CaseManagementRiskCatalogResponse[], required — Risk catalog risk types associated with the case
      - `catalog_key` string, required — Unique key for the risk catalog
      - `risk_types` CaseManagementRiskCatalogRiskTypesResponse[], required — List of risk types associated with this risk catalog
        - `key` string, required — Unique key for the risk type
    - `risk_types` CaseManagementRiskTypesResponse[], required — Risk types of case.
      - `children` CaseManagementRiskTypesChildResponse[], required — Risk type children. Only PEP and ADVERSE_MEDIA risk types have child objects.
        - `name` 'ADVERSE_MEDIA_CYBERCRIME' | 'ADVERSE_MEDIA_EU_AML_DIRECTIVE' | 'ADVERSE_MEDIA_FINANCIAL_AML_CFT' | 'ADVERSE_MEDIA_FINANCIAL_CRIME' | 'ADVERSE_MEDIA_FINANCIAL_DIFFICULTY' | 'ADVERSE_MEDIA_FRAUD_LINKED' | 'ADVERSE_MEDIA_FRAUD' | 'ADVERSE_MEDIA_GENERAL_AML_CFT' | 'ADVERSE_MEDIA_GENERAL' | 'ADVERSE_MEDIA_HIGH_RISK' | 'ADVERSE_MEDIA_NARCOTICS_AML_CFT' | 'ADVERSE_MEDIA_NARCOTICS' | 'ADVERSE_MEDIA_OTHER_FINANCIAL' | 'ADVERSE_MEDIA_OTHER_MINOR' | 'ADVERSE_MEDIA_OTHER_SERIOUS' | 'ADVERSE_MEDIA_PROPERTY' | 'ADVERSE_MEDIA_REGULATORY' | 'ADVERSE_MEDIA_SEXUAL_CRIME' | 'ADVERSE_MEDIA_TERRORISM' | 'ADVERSE_MEDIA_VIOLENCE_AML_CFT' | 'ADVERSE_MEDIA_VIOLENCE_NON_AML_CFT' | 'ADVERSE_MEDIA_VIOLENT_CRIME' | 'ADVERSE_MEDIA' | 'FITNESS_PROBITY' | 'PEP_CLASS_1_TO_3' | 'PEP_CLASS_1' | 'PEP_CLASS_2' | 'PEP_CLASS_3' | 'PEP_CLASS_4' | 'PEP' | 'SANCTION_RELATED' | 'SANCTION' | 'WARNING' | 'CUSTOM' | 'RISK_WORDS', required — Risk child name.
      - `name` 'ADVERSE_MEDIA_CYBERCRIME' | 'ADVERSE_MEDIA_EU_AML_DIRECTIVE' | 'ADVERSE_MEDIA_FINANCIAL_AML_CFT' | 'ADVERSE_MEDIA_FINANCIAL_CRIME' | 'ADVERSE_MEDIA_FINANCIAL_DIFFICULTY' | 'ADVERSE_MEDIA_FRAUD_LINKED' | 'ADVERSE_MEDIA_FRAUD' | 'ADVERSE_MEDIA_GENERAL_AML_CFT' | 'ADVERSE_MEDIA_GENERAL' | 'ADVERSE_MEDIA_HIGH_RISK' | 'ADVERSE_MEDIA_NARCOTICS_AML_CFT' | 'ADVERSE_MEDIA_NARCOTICS' | 'ADVERSE_MEDIA_OTHER_FINANCIAL' | 'ADVERSE_MEDIA_OTHER_MINOR' | 'ADVERSE_MEDIA_OTHER_SERIOUS' | 'ADVERSE_MEDIA_PROPERTY' | 'ADVERSE_MEDIA_REGULATORY' | 'ADVERSE_MEDIA_SEXUAL_CRIME' | 'ADVERSE_MEDIA_TERRORISM' | 'ADVERSE_MEDIA_VIOLENCE_AML_CFT' | 'ADVERSE_MEDIA_VIOLENCE_NON_AML_CFT' | 'ADVERSE_MEDIA_VIOLENT_CRIME' | 'ADVERSE_MEDIA' | 'FITNESS_PROBITY' | 'PEP_CLASS_1_TO_3' | 'PEP_CLASS_1' | 'PEP_CLASS_2' | 'PEP_CLASS_3' | 'PEP_CLASS_4' | 'PEP' | 'SANCTION_RELATED' | 'SANCTION' | 'WARNING' | 'CUSTOM' | 'RISK_WORDS', required — Risk type name.
      - `priority` integer, required — Risk type priority. This can be used to sort cases by priority. Priorities are: 1. ADVERSE_MEDIA 2. FITNESS_PROBITY 3. WARNING 4. PEP 5. SANCTION_RELATED 6. SANCTION
    - `stage` CaseManagementStage, required — Stage
      - `decision_type` 'POSITIVE' | 'NEGATIVE' | 'PARTIAL_POSITIVE', nullable — The decision type of the stage (decision stages only).
      - `display_name` string, required — The display name of the stage.
      - `display_order` integer, required — The display order of the stage.
      - `identifier` string, uuid, required — Stage unique identifier.
      - `stage_type` 'INITIAL' | 'REVIEW' | 'DECISION', required — The type of the stage.
    - `state` 'ONBOARDING_NOT_STARTED' | 'ONBOARDING_IN_PROGRESS' | 'ONBOARDING_ESCALATED' | 'ONBOARDING_BLOCKED' | 'ONBOARDING_POSITIVE_END_STATE' | 'ONBOARDING_MANAGEABLE_RISK_POSITIVE_END_STATE' | 'ONBOARDING_NEGATIVE_END_STATE' | 'MONITORING_NOT_STARTED' | 'MONITORING_IN_PROGRESS' | 'MONITORING_ESCALATED' | 'MONITORING_BLOCKED' | 'MONITORING_NO_RISK_DETECTED_POSITIVE_END_STATE' | 'MONITORING_RISK_DETECTED_POSITIVE_END_STATE' | 'MONITORING_RISK_DETECTED_NEGATIVE_END_STATE' | 'PAYMENT_SCREENING_NOT_STARTED' | 'PAYMENT_SCREENING_IN_PROGRESS' | 'PAYMENT_SCREENING_ESCALATED' | 'PAYMENT_SCREENING_BLOCKED' | 'PAYMENT_SCREENING_AWAITING_INFORMATION' | 'PAYMENT_SCREENING_PROCESS_PAYMENT_END_STATE' | 'PAYMENT_SCREENING_REJECT_PAYMENT_END_STATE' | 'TRANSACTION_MONITORING_NOT_STARTED' | 'TRANSACTION_MONITORING_IN_PROGRESS' | 'TRANSACTION_MONITORING_ESCALATED' | 'TRANSACTION_MONITORING_BLOCKED' | 'TRANSACTION_MONITORING_ACCEPTED_POSITIVE_END_STATE' | 'TRANSACTION_MONITORING_ESCALATED_NEGATIVE_END_STATE' | 'USER_DEFINED', required — The current state of the case. For those using the deprecated case_state, if any new case stages are added the case state response for these will be returned as USER_DEFINED
    - `subjects` CaseManagementSubject[], required — Subjects associated with the case, capped at the first 100.
      - union — Case subject.
        - CaseManagementPersonSubject — Person customer subject.
          - `detail` CaseManagementPersonSubjectDetail, required — Person customer subject detail.
            - `type` 'PERSON', required
          - `external_identifier` string, nullable — Customer external identifier.
          - `identifier` string, uuid, required — Customer unique identifier.
          - `name` string, required — Customer name.
          - `risk_level` 'LOW' | 'MEDIUM' | 'HIGH' | 'PROHIBITED' | 'SKIPPED', nullable — Customer current risk level.
          - `type` 'CUSTOMER', required
          - `version` integer, required — Customer version.
        - CaseManagementCompanySubject — Company customer subject.
          - `detail` CaseManagementCompanySubjectDetail, required — Company customer subject detail.
            - `type` 'COMPANY', required
          - `external_identifier` string, nullable — Customer external identifier.
          - `identifier` string, uuid, required — Customer unique identifier.
          - `name` string, required — Customer name.
          - `risk_level` 'LOW' | 'MEDIUM' | 'HIGH' | 'PROHIBITED' | 'SKIPPED', nullable — Customer current risk level.
          - `type` 'CUSTOMER', required
          - `version` integer, required — Customer version.
        - CaseManagementVesselSubject — Vessel customer subject.
          - `detail` CaseManagementVesselSubjectDetail, required — Vessel customer subject detail.
            - `type` 'VESSEL', required
          - `external_identifier` string, nullable — Customer external identifier.
          - `identifier` string, uuid, required — Customer unique identifier.
          - `name` string, required — Customer name.
          - `risk_level` 'LOW' | 'MEDIUM' | 'HIGH' | 'PROHIBITED' | 'SKIPPED', nullable — Customer current risk level.
          - `type` 'CUSTOMER', required
          - `version` integer, required — Customer version.
        - CaseManagementUndefinedSubject — Undefined customer subject.
          - `detail` CaseManagementUndefinedSubjectDetail, required — Undefined customer subject detail.
            - `type` 'UNDEFINED', required
          - `external_identifier` string, nullable — Customer external identifier.
          - `identifier` string, uuid, required — Customer unique identifier.
          - `name` string, required — Customer name.
          - `risk_level` 'LOW' | 'MEDIUM' | 'HIGH' | 'PROHIBITED' | 'SKIPPED', nullable — Customer current risk level.
          - `type` 'CUSTOMER', required
          - `version` integer, required — Customer version.
        - CaseManagementBankPaymentSubject — Transaction subject as a bank payment.
          - `detail` CaseManagementBankPaymentSubjectDetail, required — Bank payment subject detail.
            - `type` 'BANK_PAYMENT', required
          - `external_identifier` string, required — Transaction external identifier.
          - `identifier` string, uuid, required — Transaction unique identifier.
          - `type` 'TRANSACTION', required
        - CaseManagementCardPaymentSubject — Transaction subject as a card payment.
          - `detail` CaseManagementCardPaymentSubjectDetail, required — Card payment subject detail.
            - `type` 'CARD_PAYMENT', required
          - `external_identifier` string, required — Transaction external identifier.
          - `identifier` string, uuid, required — Transaction unique identifier.
          - `type` 'TRANSACTION', required
        - CaseManagementRemittancePaymentSubject — Transaction subject as a remittance payment.
          - `detail` CaseManagementRemittancePaymentSubjectDetail, required — Remittance payment subject detail.
            - `type` 'REMITTANCE', required
          - `external_identifier` string, required — Transaction external identifier.
          - `identifier` string, uuid, required — Transaction unique identifier.
          - `type` 'TRANSACTION', required
        - CaseManagementCryptoPaymentSubject — Transaction subject as a crypto payment.
          - `detail` CaseManagementCryptoPaymentSubjectDetail, required — Crypto payment subject detail.
            - `type` 'CRYPTO', required
          - `external_identifier` string, required — Transaction external identifier.
          - `identifier` string, uuid, required — Transaction unique identifier.
          - `type` 'TRANSACTION', required
        - object — Counterparty subject.
          - `external_identifier` string, required — Counterparty external identifier.
          - `name` string, nullable — Counterparty name.
          - `type` 'COUNTERPARTY', required — The type of the subject.
    - `subjects_summary` CaseManagementSubjectsSummary, required — Summary information about the subjects associated with a case.
      - `total_count` integer, required — The total number of subjects associated with the case.
    - `type` 'CUSTOMER_ONBOARDING' | 'CUSTOMER_MONITORING' | 'PAYMENT_SCREENING' | 'TRANSACTION_MONITORING', required — Case type.
    - `updated_at` string, date-time, required — Case last updated date and time.
    - `updated_by` string, uuid, nullable — Last state of case set by an user.
  - `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)