> ## Documentation Index
> Fetch the complete documentation index at: https://docs.borderless.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Identity Compliance Webhooks

<Note>
  If you're just getting started, please check out our [quick start guide](/docs/quick-start-guide).
</Note>

Compliance check creation, regardless was it successful or not, results into webhooks delivered to the registered addresses.

### Completed

When identity compliance check completes, either with Approved or Rejected KYC status, system sends **IdentityComplianceCheck\_Completed** webhook.

<CodeGroup>
  ```bash bash theme={null}
  {
    "type": "IdentityComplianceCheck_Completed",
    "organizationId": "clwf218k000001wrwr7dvi9wp",
    "timestamp": 1740071905278,
    "data": {
      "id": "cm7dlpeon000kp925og708phy",
      "identityId": "cm7dloxy8000gp925tzej8sxk",
      "status": "Approved",
      "metadata": {
        "hasAcceptedTos": true,
        "rejectionReason": []
      }
    }
  }
  ```
</CodeGroup>

<CodeGroup>
  ```bash bash theme={null}
  {
    "type": "IdentityComplianceCheck_Completed",
    "organizationId": "clwf218k000001wrwr7dvi9wp",
    "timestamp": 1740071905278,
    "data": {
      "id": "cm7dlpeon000kp925og708phy",
      "identityId": "cm7dloxy8000gp925tzej8sxk",
      "status": "Rejected",
      "metadata": {
        "hasAcceptedTos": true,
        "rejectionReasons": [
          {
            "code": "DocumentExpired",
            "description": "Document has expired.",
            "pfiMessage": "ID is expired."
          },
          {
            "code": "FaceNotLive",
            "description": "Liveness check failed.",
            "pfiMessage": "The selfie video shows signs of presentation attack."
          }
        ]
      }
    }
  }
  ```
</CodeGroup>

Changes during compliance check process are reflected via **IdentityComplianceCheck\_Updated** webhooks, e.g. when a customer accepts terms of service or there is a change in KYC status.

### Updated

<CodeGroup>
  ```bash bash theme={null}
  {
    "type": "IdentityComplianceCheck_Updated",
    "organizationId": "clwf218k000001wrwr7dvi9wp",
    "timestamp": 1740071905278,
    "data": {
      "id": "cm7dlpeon000kp925og708phy",
      "identityId": "cm7dloxy8000gp925tzej8sxk",
      "status": "UnderReview",
      "metadata": {
        "hasAcceptedTos": true,
        "rejectionReason": []
      }
    }
  }
  ```
</CodeGroup>

<Info>
  If you have any questions, please don't hesitate to reach out to us via [email](mailto:support@borderless.xyz) or slack.
</Info>
