# Return Compliance Alerts

Returns compliance alerts for a company by automatically fetching the company report using the provided connectId or Safe Number, extracting required data (directors, UBOs, etc.), and processing it through the compliance alerts API. This eliminates the need for manual report retrieval and data transformation.


Endpoint: GET /compliance/kyc-protect/complianceAlerts/{connectId}
Version: 1.10.9
Security: bearerToken

## Path parameters:

  - `connectId` (string, required)
    The connectId (optionally Safe Number where available) of the Company required to order their Credit Report.
    Example: "GB-0-03836192"

## Response 202 fields (application/json):

  - `safeNumber` (string)
    Safe number of the company or entity.

  - `name` (string)
    Name of the company or entity.

  - `countryCode` (string)
    Two-letter ISO country code.

  - `entities` (object)
    Entities associated with the alert, grouped by property.

 Any properties with no available data are excluded from the response.

  - `entities.currentDirectors` (array)
    directors detail related to the alert.

  - `entities.currentDirectors.type` (string)
    Type of the entity (e.g., individual, business).

  - `entities.currentDirectors.name` (string)
    Full name of the entity.

  - `entities.currentDirectors.firstName` (string)
    First name of the entity (if individual).

  - `entities.currentDirectors.middleName` (string)
    Middle name of the entity (if individual).

  - `entities.currentDirectors.lastName` (string)
    Last name of the entity (if individual).

  - `entities.currentDirectors.countryCode` (string)
    Country code of the entity.

  - `entities.currentDirectors.gender` (string)
    Gender of the entity (if individual).

  - `entities.currentDirectors.dateOfBirth` (string)
    Date of birth details for the entity.

  - `entities.currentDirectors.hasAlerts` (boolean)
    Indicates if the entity has alerts.

  - `entities.ubos` (array)
    Ultimate Beneficial Owners (UBOs) detail related to the alert.

 If the UBO type is 'business', the properties firstName, middleName, lastName, gender, and dateOfBirth are omitted.

  - `hasAlerts` (boolean)
    Indicates if there are any alerts for the response.

  - `entitiesWithAlerts` (number)
    Number of entities with alerts.

  - `lastUpdated` (string)
    Timestamp of the last update.

## Response 400 fields (application/json):

  - `correlationId` (string)
    A unique ID assigned to this request.

  - `message` (string)

  - `details` (string)
    Provides further information on why the request was rejected

## Response 401 fields (application/json):

  - `error` (string)

## Response 403 fields (application/json):

  - `message` (string)
    Example: "Access forbidden"

## Response 409 fields (application/json):

  - `correlationId` (string)
    The unique identifier. (A UUID specified by RFC4122).

  - `message` (string)

  - `details` (string)
    Provides further information on why the request was rejected

## Response 502 fields (application/json):

  - `correlationId` (string)
    A unique ID assigned to this request.

  - `message` (string)

  - `details` (string)
    Provides further information on why the request was rejected