# Consumer KYC status update

Notification that the KYC status of a consumer identity has been updated.

Endpoint: POST /consumers/kyc/watch
Version: v2

## Header parameters:

  - `call-ref` (string)
    A call reference generated by the caller and unique to the caller to provide correlation between the caller and system with a maximum length of 255

  - `published-timestamp` (integer, required)
    The timestamp, expressed in Epoch timestamp using millisecond precision, when this event was published.

  - `signature-v2` (string, required)
    The signature to verify the authenticity of this request.  This is the base64 hash (HmacSHA256) of the call-ref + payload + published-timestamp using your API key.

  - `signature` (string, required)
    The signature to verify the authenticity of this request.  This is the base64 hash (HmacSHA256) of the published-timestamp using your API key.

## Request fields (application/json):

  - `consumerId` (string)

  - `consumerEmail` (string)

  - `status` (string)
    Enum: "UNDEFINED", "NOT_STARTED", "INITIATED", "PENDING_REVIEW", "APPROVED", "REJECTED"

  - `details` (array)
    Action which my be required to re-process kyc in case of temporary rejections.
    Enum: "UNDEFINED_KYC_FAILURE_REASON", "DOCUMENTS_UNSATISFACTORY", "SUPPLIED_DATA_AND_DOCUMENTS_MISMATCH", "LANGUAGE_IN_DOCUMENTS_UNSUPPORTED", "SELFIE_UNSATISFACTORY", "SELFIE_AND_DOCUMENTS_MISMATCH", "OTHER", "UNSUPPORTED_COUNTRY", "PEP_STATUS", "REJECTED_DUPLICATE", "EXPIRED_KYC_DOCUMENTS"

  - `rejectionComment` (string)
    Reason shown to the user in case of temporary rejection.

  - `ongoingStatus` (string)
    Enum: "UNDEFINED", "NOT_STARTED", "INITIATED", "PENDING_REVIEW", "APPROVED", "REJECTED"

  - `eventTimestamp` (string)
    Epoch timestamp using millisecond precision.

  - `additionalInformation` (object)
    Additional information related to the event triggering this notification.

  - `additionalInformation.documentExpiryDate` (string)
    Epoch timestamp using millisecond precision.

  - `additionalInformation.identityRestrictionDate` (string)
    Epoch timestamp using millisecond precision.

  - `kycLevel` (string)
    The KYC level, which determines what KYC information will be requested from the consumer:
  - KYC_LEVEL_1: The most basic level of KYC required. 
  - KYC_LEVEL_2: Full due diligence level 2
    Enum: "KYC_LEVEL_1", "KYC_LEVEL_2"

  - `ongoingKycLevel` (string)
    The KYC level, which determines what KYC information will be requested from the consumer:
  - KYC_LEVEL_1: The most basic level of KYC required. 
  - KYC_LEVEL_2: Full due diligence level 2
    Enum: "KYC_LEVEL_1", "KYC_LEVEL_2"


## Response 204 fields