# Get all business partner cases.

Endpoint to get all business partner cases.

Endpoint: GET /cases
Version: 1
Security: apiKey

## Query parameters:

  - `caseId` (string)
    ID of the case.
    Example: "123"

  - `dataSourceId` (string)
    ID of the business partner storage data source.
    Example: "648824a691d8d2503d65103e"

  - `businessPartnerId` (string)
    ID of the business partner.
    Example: "63e635235c06b7396330fe40"

  - `businessPartnerName` (string)
    Name of the business partner.
    Example: "Apple"

  - `screeningScore` (number)
    Screening score.
    Example: 0.8

  - `fromDate` (string)
    Date from a point in time.
    Example: "2025-08-27T14:26:38Z"

  - `toDate` (string)
    Date to a point in time.
    Example: "2025-08-27T14:26:38Z"

  - `listTypes` (array)
    Types of the compliance list.
    Enum: "SL", "PEP", "WL"

  - `listAuthority` (string)
    Authority of the list.
    Example: "United States Department of the Treasury"

  - `listName` (string)
    Name of the list.
    Example: "OFAC"

  - `status` (string)
    Status of the case.
    Enum: "OPEN", "CLOSED", "OUTDATED"

  - `systemStatus` (string)
    System status of the case.
    Enum: "VALID", "OUTDATED", "DELETED"

  - `decisionType` (string)
    Type of the decision.
    Enum: "CREATE", "CONFIRMED", "CLEARED", "REOPEN", "DELETED", "OUTDATED", "REVALIDATED"

  - `onlyOpenCases` (boolean)
    Flag to filter business partners with open cases.
    Example: true

  - `sort` (string)
    Defines the attributes to sort by. The result is sorted in ascending order. To use descending order use prefix -. Sorting is available only for a single attribute.
Available options:
  * 
  * 
  * 
  * 
  * 
  * 
  * 
  * 
  * 
  * 
  * 
  *
    Example: "-lastCheckedAt"

  - `startAfter` (string)
    Pagination cursor which should be filled with nextStartAfter value provided in the previous page read response.
    Example: "NjI4ZGNkZjAzYjlkMjY4NjhlNjQxNDRm"

  - `limit` (integer)
    Number of resources to be returned on the page.
    Example: "200"

## Response 200 fields (application/json):

  - `values` (array)

  - `values.id` (string)
    ID of the case.
    Example: "123"

  - `values.version` (string)
    Version of the case.
    Example: "1"

  - `values.info4cId` (string)
    ID of the provided Info4c entry.
    Example: "123"

  - `values.dataMirrorId` (string)
    ID of the data mirror.
    Example: "123"

  - `values.dataSourceId` (string)
    Unique identifier for a Data Source of the Storage.
    Example: "648824a691d8d2503d65103e"

  - `values.dataSourceName` (string)
    Name of a data source of a storage.
    Example: "Internal customers"

  - `values.screeningScore` (number)
    Matching score calculated during screening.
    Example: 0.8

  - `values.issuingDate` (string)
    Date of the issuing.
    Example: "2025-08-27T14:26:38Z"

  - `values.modificationDate` (string)
    Date of the modification.
    Example: "2025-08-27T14:26:38Z"

  - `values.businessPartnerId` (string)
    A CDQ ID identifies a business partner uniquely in the context of the Corporate Data League.
    Example: "63e635235c06b7396330fe40"

  - `values.businessPartnerName` (string)
    Name of the business partner.
    Example: "Apple"

  - `values.country` (string)
    Country code (ISO 3166-1 alpha-2).
    Example: "CH"

  - `values.listType` (string)
    Type of the list.
    Enum: "SL", "PEP", "WL"

  - `values.screeningDate` (string)
    Date of the last screening.
    Example: "2025-08-27T14:26:38Z"

  - `values.listAuthority` (string)
    Authority of the list.
    Example: "United States Department of the Treasury"

  - `values.listName` (string)
    Name of the list.
    Example: "OFAC"

  - `values.decisionDate` (string)
    Date of the decision.
    Example: "2025-08-27T14:26:38Z"

  - `values.complianceDataSource` (object)
    Data source of the compliance screening.
    Example: "AML"

  - `values.complianceDataSource.technicalKey` (string)
    Technical key of the data source.
    Example: "INFO4C_WL_37"

  - `values.decisions` (array)

  - `values.decisions.reviewerName` (string)
    Name of the reviewer.
    Example: "John Doe"

  - `values.decisions.reviewerId` (string)
    Unique ID of a user.
    Example: "johndoe"

  - `values.decisions.createdAt` (string)
    Date of creation (ISO 8601-compliant).
    Example: "2025-08-27T14:26:38Z"

  - `values.decisions.type` (string)
    Status of the decision.
    Enum: "CREATE", "CONFIRMED", "CLEARED", "REOPEN", "DELETED", "OUTDATED", "REVALIDATED"

  - `values.decisions.comment` (string)
    Comment for the decision.
    Example: "My decision"

  - `values.decisions.reason` (string)
    Reason of the decision.
    Enum: "FALSE_POSITIVE", "DUPLICATE_CASE", "SANCTION_NOT_APPLICABLE", "BUSINESS_PARTNER_CLEARED", "INSUFFICIENT_EVIDENCE", "DATA_ERROR", "MITIGATED_RISK", "COMPLIANCE_EXCEPTION_GRANTED", "FIRST_MATCH", "CONFIRMED_MATCH", "BUSINESS_RELATIONSHIP_TERMINATED", "CONTRACTUAL_ACTIONS_TAKEN", "REPORT_TO_AUTHORITIES", "BUSINESS_RESTRICTIONS_IMPOSED", "RISK_MITIGATION_MEASURES_APPLIED", "ONGOING_MONITORING", "NEW_INFORMATION_OR_EVIDENCE", "REGULATORY_CHANGES", "INCREASED_RISK_PROFILE", "MONITORING_ALERT", "AUDIT_FINDINGS", "BUSINESS_PARTNER_SANCTIONED", "COMPLIANCE_POLICY_CHANGE", "CORRECTION_OF_DATA_ERROR", "FAILURE_TO_IMPLEMENT_REMEDIATION", "BUSINESS_PARTNER_DELETION", "COMPLIANCE_RECORD_DELETION", "COMPLIANCE_RECORD_NO_LONGER_MATCHES"

  - `values.decisions.caseStatus` (string)
    Status of the case.
    Enum: "OPEN", "CLOSED", "OUTDATED"

  - `values.decisions.caseSystemStatus` (string)
    System status of the case.
    Enum: "VALID", "OUTDATED", "DELETED"

  - `values.decisions.amlCaseHistoryId` (string)
    ID of the screening history entry.
    Example: "6735c38c8fedd67d354791ad"

  - `values.configurationId` (object)
    Configuration ID.

  - `values.configurationId.id` (string)
    ID of the configuration.
    Example: "123"

  - `values.configurationId.version` (string)
    Version of the configuration.
    Example: "0"

  - `values.status` (string)
    Status of the case.
    Enum: "OPEN", "CLOSED", "OUTDATED"

  - `values.systemStatus` (string)
    System status of the case.
    Enum: "VALID", "OUTDATED", "DELETED"

  - `startAfter` (string)
    The ID which is used to read the page.
    Example: "5712566172571652"

  - `nextStartAfter` (string)
    Provides a value to be used as a startAfter in next page request.
    Example: "5712566172571652"

  - `limit` (integer)
    Number of items per page.
    Example: "100"

  - `total` (integer)
    Total number of items which can be paged.
    Example: "67"

## Response 400 fields (application/json):

  - `status` (object)
    Details about status or error of a service

  - `status.code` (integer, required)
    RFC 7231 status code for this error.
    Example: "400"

  - `status.technicalKey` (string, required)
    Technical key describing the status or error
    Example: "OK"

  - `status.details` (array, required)

  - `status.details.id` (integer, required)
    9-digit code which is uniquely identifying a message
    Example: 200000004

  - `status.details.message` (string, required)
    Human-readable message which may also be presented in user interface.
    Example: "Business Partner Name is mandatory."

  - `status.details.technicalKey` (string)
    Technical key to uniquely identify a message.
    Example: "JOB_FINISHED"

  - `status.details.jsonPath` (string)
    JSONPath as specified by the IETF standard
    Example: "$.businessPartner.names[0].value"

  - `status.details.jsonRecord` (string)
    Object provided in plain JSON format.
    Example: "{ \"key\" : \"value\"}"

  - `status.path` (string)
    Requested path which caused this error.
    Example: "/v2/businesspartners/lookup"

  - `status.timestamp` (string)
    ISO 8601 representation of the timestamp.
    Example: "2025-08-27T14:26:38Z"