# List Fraud Cases

Display a page of Fraud Cases.

Endpoint: GET /fraudcases
Version: 2
Security: apiKey

## Query parameters:

  - `page` (integer)
    The page index. The index of the first page is 0.
    Example: "0"

  - `pageSize` (integer)
    Number of records listed on one page.
    Example: "200"

  - `sort` (string)
    Defines the attributes to sort by.
    Example: "-dateOfAttack"

  - `search` (string)
    The phrase that the query will look for.
    Example: "phrase"

  - `classification` (string)
    Classification used to filter results.
    Example: "STANDARD"

## Response 200 fields (application/json):

  - `page` (integer)
    The page index. The index of the first page is 0.
    Example: "0"

  - `pageSize` (integer)
    Number of records listed on one page.
    Example: "20"

  - `numberOfPages` (integer)
    Total number of pages.
    Example: "10"

  - `recordCount` (integer)
    Total number of records.
    Example: "2000"

  - `sortField` (string)
    The field used for sorting.
    Example: "dateOfAttack"

  - `ascending` (boolean)
    Sort order.
    Example: "true"

  - `fraudCases` (array)
    List of fraud cases.

  - `fraudCases.cdlId` (string)
    Unique identifier of the fraud case.
    Example: "5c6a2c7e-9b0a-4e1a-8b0a-4e1a8b0a4e1a"

  - `fraudCases.version` (integer)
    Version of the fraud case.
    Example: "1"

  - `fraudCases.dateOfAttack` (string)
    Date of the attack.
    Example: "2025-08-29T09:46:42Z"

  - `fraudCases.type` (string)
    Fraud case type. Available options:
  * : Active warning.
  * : Announcement. 
  * : Fake document.
  * : Fake email.
  * : Fake president call.
  * : Falsified invoice.
    Example: "ACTIVE_WARNING"

  - `fraudCases.description` (string)
    Description of the fraud case.
    Example: "Fraud case description"

  - `fraudCases.internalComment` (string)
    Internal comment of the fraud case.
    Example: "Internal comment"

  - `fraudCases.confirmationState` (string)
    Confirmation state. Available options:
  * : Confirmed.
  * : Suspected.
    Example: "CONFIRMED"

  - `fraudCases.classification` (string)
    Classification of the fraud case.
    Enum: "DEMO", "TEST", "CATENAX", "STANDARD"

  - `fraudCases.businessPartnerName` (string)
    The actual name.
    Example: "Corporate Data Quality AG"

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

  - `fraudCases.businessPartnerLocality` (string)
    Name of the [Locality](https://meta.cdq.com/Address/locality).
    Example: "Sankt Gallen"

  - `fraudCases.fraudsterEmail` (string)
    Email of the fraudster.
    Example: "thisisnot@fraud.com"

  - `fraudCases.fraudsterPhone` (string)
    Phone of the fraudster.
    Example: "+49123456789"

  - `fraudCases.fraudsterWebsite` (string)
    Website of the fraudster.
    Example: "www.thisisnotafraud.com"

  - `fraudCases.alternativePayee` (string)
    Alternative payee of the fraud case.
    Example: "Alternative payee's name"

  - `fraudCases.bankAccount` (object)
    A bank account record holds information that universally describes a registered bank account.

  - `fraudCases.bankAccount.internationalBankAccountIdentifier` (string)
    The IBAN of a bank account.
    Example: "CH8800781619278412000"

  - `fraudCases.bankAccount.internationalBankIdentifier` (string)
    (BIC/SWIFT) Bank identifier which is globally unique.
    Example: "KBSGCH22XXX"

  - `fraudCases.bankAccount.bankCountryCode` (string)
    ISO code to identify the country a bank account is registered in.
    Example: "DE"

  - `fraudCases.bankAccount.nationalBankIdentifier` (string)
    Bank identifier which is unique in a national context, i.e. for a country.
    Example: "00781"

  - `fraudCases.bankAccount.nationalBankAccountIdentifier` (string)
    Identifier of a bank account in a national context, i.e. for a country.
    Example: "619278412000"

  - `fraudCases.archived` (boolean)
    Indicates if the fraud case is archived.
    Example: "false"

  - `fraudCases.alertTriggered` (boolean)
    Indicates if an alert was triggered.
    Example: "false"

  - `fraudCases.createdAt` (string)
    Creation timestamp of the fraud case.
    Example: "2025-08-29T09:46:42Z"

  - `fraudCases.creatorOrganization` (string)
    Creator organization of the fraud case.
    Example: "Organization name"

  - `fraudCases.createdBy` (string)
    Creator user of the fraud case.
    Example: "User name"

  - `fraudCases.disclosedAttributes` (array)
    Available disclosed attributes:
  * : Bank account bank country code.
  * : Bank account bank name.
  * : Bank account international bank identifier.
  * : Bank account international bank account identifier.
  * : Bank account national bank identifier.
  * : Bank account national bank account identifier.
  * : Fraud case CDL ID.
  * : Fraud case alternative payee.
  * : Fraud case business partner name.
  * : Fraud case business partner country code.
  * : Fraud case business partner locality.
  * : Fraud case date of attack.
  * : Fraud case creation timestamp.
  * : Fraud case description.
  * : Fraud case internal comment.
  * : Fraud case fraudster email.
  * : Fraud case fraudster phone.
  * : Fraud case fraudster website.
  * : Fraud case type.
  * : Fraud case confirmation state.
  * : Fraud case creator organization.
  * : Fraud case creator user.
  * : Fraud case disclosed attributes bank account bank name.
  * : Fraud case disclosed attributes bank account bank country code.
  * : Fraud case disclosed attributes bank account international bank identifier.
  * : Fraud case disclosed attributes bank account international bank account identifier.
  * : Fraud case disclosed attributes bank account national bank identifier.
  * : Fraud case disclosed attributes bank account national bank account identifier.
  * : Fraud case disclosed attributes fraud case alternative payee.
  * : Fraud case disclosed attributes fraud case business partner name.
  * : Fraud case disclosed attributes fraud case business partner country code.
  * : Fraud case disclosed attributes fraud case business partner locality.
  * : Fraud case disclosed attributes fraud case date of attack.
  * : Fraud case disclosed attributes fraud case creation timestamp.
  * : Fraud case disclosed attributes fraud case description.
  * : Fraud case disclosed attributes fraud case fraudster email.
  * : Fraud case disclosed attributes fraud case fraudster phone.
  * : Fraud case disclosed attributes fraud case fraudster website.
  * : Fraud case disclosed attributes fraud case type.
  * : Fraud case disclosed attributes fraud case confirmation state.
  * : Fraud case disclosed attributes fraud case creator organization.
  * : Fraud case disclosed attributes fraud case creator user.
    Enum: "BANKACCOUNT_BANK_COUNTRY_CODE", "BANKACCOUNT_BANK_NAME", "BANKACCOUNT_INTERNATIONAL_BANK_IDENTIFIER", "BANKACCOUNT_INTERNATIONAL_BANK_ACCOUNT_IDENTIFIER", "BANKACCOUNT_NATIONAL_BANK_IDENTIFIER", "BANKACCOUNT_NATIONAL_BANK_ACCOUNT_IDENTIFIER", "FRAUDCASE_CDL_ID", "FRAUDCASE_ALTERNATIVE_PAYEE", "FRAUDCASE_BUSINESS_PARTNER_NAME", "FRAUDCASE_BUSINESS_PARTNER_COUNTRY_CODE", "FRAUDCASE_BUSINESS_PARTNER_LOCALITY", "FRAUDCASE_DATE_OF_ATTACK", "FRAUDCASE_CREATION_TIMESTAMP", "FRAUDCASE_DESCRIPTION", "FRAUDCASE_INTERNAL_COMMENT", "FRAUDCASE_FRAUDSTER_EMAIL", "FRAUDCASE_FRAUDSTER_PHONE", "FRAUDCASE_FRAUDSTER_WEBSITE", "FRAUDCASE_TYPE", "FRAUDCASE_CONFIRMATION_STATE", "FRAUDCASE_CREATOR_ORGANIZATION", "FRAUDCASE_CREATOR_USER", "FRAUDCASE_DISCLOSED_ATTRIBUTES_BANKACCOUNT_BANK_NAME", "FRAUDCASE_DISCLOSED_ATTRIBUTES_BANKACCOUNT_BANK_COUNTRY_CODE", "FRAUDCASE_DISCLOSED_ATTRIBUTES_BANKACCOUNT_INTERNATIONAL_BANK_IDENTIFIER", "FRAUDCASE_DISCLOSED_ATTRIBUTES_BANKACCOUNT_INTERNATIONAL_BANK_ACCOUNT_IDENTIFIER", "FRAUDCASE_DISCLOSED_ATTRIBUTES_BANKACCOUNT_NATIONAL_BANK_IDENTIFIER", "FRAUDCASE_DISCLOSED_ATTRIBUTES_BANKACCOUNT_NATIONAL_BANK_ACCOUNT_IDENTIFIER", "FRAUDCASE_DISCLOSED_ATTRIBUTES_FRAUDCASE_ALTERNATIVE_PAYEE", "FRAUDCASE_DISCLOSED_ATTRIBUTES_FRAUDCASE_BUSINESS_PARTNER_NAME", "FRAUDCASE_DISCLOSED_ATTRIBUTES_FRAUDCASE_BUSINESS_PARTNER_COUNTRY_CODE", "FRAUDCASE_DISCLOSED_ATTRIBUTES_FRAUDCASE_BUSINESS_PARTNER_LOCALITY", "FRAUDCASE_DISCLOSED_ATTRIBUTES_FRAUDCASE_DATE_OF_ATTACK", "FRAUDCASE_DISCLOSED_ATTRIBUTES_FRAUDCASE_CREATION_TIMESTAMP", "FRAUDCASE_DISCLOSED_ATTRIBUTES_FRAUDCASE_DESCRIPTION", "FRAUDCASE_DISCLOSED_ATTRIBUTES_FRAUDCASE_FRAUDSTER_EMAIL", "FRAUDCASE_DISCLOSED_ATTRIBUTES_FRAUDCASE_FRAUDSTER_PHONE", "FRAUDCASE_DISCLOSED_ATTRIBUTES_FRAUDCASE_FRAUDSTER_WEBSITE", "FRAUDCASE_DISCLOSED_ATTRIBUTES_FRAUDCASE_TYPE", "FRAUDCASE_DISCLOSED_ATTRIBUTES_FRAUDCASE_CONFIRMATION_STATE", "FRAUDCASE_DISCLOSED_ATTRIBUTES_FRAUDCASE_CREATOR_ORGANIZATION", "FRAUDCASE_DISCLOSED_ATTRIBUTES_FRAUDCASE_CREATOR_USER"

  - `fraudCases.relatedFraudCases` (integer)
    Number of related fraud cases.
    Example: "5"

## Response 400 fields (application/json):

  - `id` (string)
    Unique identifier of the error.
    Example: "5c6a2c7e-9b0a-4e1a-8b0a-4e1a8b0a4e1a"

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

  - `timestamp` (string)
    ISO 8601 representation of the timestamp.
    Example: "2025-08-29T09:46:42Z"

  - `message` (string)
    Details about the error.
    Example: "This user is not allowed to access this service."

  - `error` (string)
    RFC 7231 error which belongs to the status code.
    Example: "BAD_REQUEST"

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

## Response 401 fields (application/json):

  - `id` (string)
    Unique identifier of the error.
    Example: "5c6a2c7e-9b0a-4e1a-8b0a-4e1a8b0a4e1a"

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

  - `timestamp` (string)
    ISO 8601 representation of the timestamp.
    Example: "2025-08-29T09:46:42Z"

  - `message` (string)
    Details about the error.
    Example: "This user is not allowed to access this service."

  - `error` (string)
    RFC 7231 error which belongs to the status code.
    Example: "BAD_REQUEST"

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

## Response 403 fields (application/json):

  - `id` (string)
    Unique identifier of the error.
    Example: "5c6a2c7e-9b0a-4e1a-8b0a-4e1a8b0a4e1a"

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

  - `timestamp` (string)
    ISO 8601 representation of the timestamp.
    Example: "2025-08-29T09:46:42Z"

  - `message` (string)
    Details about the error.
    Example: "This user is not allowed to access this service."

  - `error` (string)
    RFC 7231 error which belongs to the status code.
    Example: "BAD_REQUEST"

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

## Response 404 fields (application/json):

  - `id` (string)
    Unique identifier of the error.
    Example: "5c6a2c7e-9b0a-4e1a-8b0a-4e1a8b0a4e1a"

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

  - `timestamp` (string)
    ISO 8601 representation of the timestamp.
    Example: "2025-08-29T09:46:42Z"

  - `message` (string)
    Details about the error.
    Example: "This user is not allowed to access this service."

  - `error` (string)
    RFC 7231 error which belongs to the status code.
    Example: "BAD_REQUEST"

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

## Response 406 fields (application/json):

  - `id` (string)
    Unique identifier of the error.
    Example: "5c6a2c7e-9b0a-4e1a-8b0a-4e1a8b0a4e1a"

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

  - `timestamp` (string)
    ISO 8601 representation of the timestamp.
    Example: "2025-08-29T09:46:42Z"

  - `message` (string)
    Details about the error.
    Example: "This user is not allowed to access this service."

  - `error` (string)
    RFC 7231 error which belongs to the status code.
    Example: "BAD_REQUEST"

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

## Response 503 fields (application/json):

  - `id` (string)
    Unique identifier of the error.
    Example: "5c6a2c7e-9b0a-4e1a-8b0a-4e1a8b0a4e1a"

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

  - `timestamp` (string)
    ISO 8601 representation of the timestamp.
    Example: "2025-08-29T09:46:42Z"

  - `message` (string)
    Details about the error.
    Example: "This user is not allowed to access this service."

  - `error` (string)
    RFC 7231 error which belongs to the status code.
    Example: "BAD_REQUEST"

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