---
title: "Identity Verification Webhook - Sandbox Approved"
source_url: https://docs.rapyd.net/en/identity-verification-webhook---sandbox-approved.html
lang: en
---

# Identity Verification Webhook - Sandbox Approved

The **IDENTITY_VERIFICATION** webhook is sent when Rapyd completes the process of verifying a person’s identity.

> **Note:**
>
> The endpoint for webhooks is unique for each client. To set up a webhook endpoint, see [Defining a Webhook Endpoint](https://docs.rapyd.net/en/defining-a-webhook-endpoint.md "Defining a Webhook Endpoint").

### Parameters

### Webhook Header Parameters

- - Content-Type
  - Indicates that the data appears in JSON format. Set to **application/json**.
- - salt
  - Random string.
- - signature
  - Signature calculated for each webhook individually.

    See [Webhook Authentication](https://docs.rapyd.net/en/webhook-authentication.md "Webhook Authentication").
- - timestamp
  - Timestamp for the webhook, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time") (seconds).

### Webhook Root Parameters

- - created_at
  - Time that the webhook was created, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time").

    > **Note:**
    >
    > Inside the `data` object, some webhooks have another `created_at` field that refers to a different event.
- - data
  - Contains the actual data of the webhook.

    For details, see below.
- - extended_timestamp
  - Time in milliseconds that the webhook was created, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time").
- - id
  - ID of the webhook. String starting with **wh_**.
- - status
  - Status of the webhook. One of the following:

    - **NEW**
    - **CLO** - Closed.
    - **ERR** - Error.
    - **RET** - Re-sent.

    > **Note:**
    >
    > Inside the `data` object, some webhooks have another `status` field that refers to a different event.
- - trigger_operation_id
  - ID of the operation that triggered the webhook. UUID.
- - type
  - Name of the webhook type.

    > **Note:**
    >
    > The name in the Client Portal is different.

### Webhook Data Parameters

- - additional_data
  - Additional data.
- - address
  - The address of the individual.
- - contact
  - ID of the wallet contact. String starting with **cont_**.
- - country
  - The two-letter ISO 3166-1 ALPHA-2 code for the country of the identification document.
- - country_match
  - Indicates whether the individual's country matches the country on the identification document.
- - created_at
  - Time of the identity verification operation, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time").
- - date_of_birth
  - Date of birth of the individual.
- - dob_match
  - Indicates whether the individual's date of birth matches the date of birth on the identification document.
- - document_sub_type
  - Subtype of the identification document.
- - document_type
  - Type of identification document. Two-letter code.
- - error_reason
  - Reason for not approving the verification request.
- - ewallet
  - ID of the Rapyd Wallet. String starting with **ewallet_**.
- - ewallet_id
  - ID of the Rapyd Wallet. String starting with **ewallet_**.
- - expiration_date
  - Reserved.
- - face_validation
  - Indicates whether face verification was performed.
- - first_name
  - First name of the individual.
- - gender
  - Gender of the individual.
- - id
  - ID of the identity verification operation. String starting with **kycid_**.
- - id_number
  - ID number as shown on the identification document.
- - images
  - Link to the images that were used for this verification.
- - last_name
  - Last name of the individual.
- - name_match
  - Indicates whether the individual's full name matches the full name on the identification document.
- - reference_id
  - ID of the identity verification request. Must be unique for each request. Defined by the client.
- - reject_reason
  - Reason for not approving the individual. See [Identity Verification Errors](https://docs.rapyd.net/en/identity-verification-errors.md "Identity Verification Errors").
- - request_source
  - Type of device that supplied the images.
- - state
  - State of residence of the individual, as shown on the identification document.
- - verification_status
  - Indicates whether the individual was approved. One of the following:

    - **APPROVED** - The individual was approved.
    - **NOT_APPROVED** - The individual was not approved.

- IDENTITY_VERIFICATION Webhook (Sandbox - approved)
- ```json
  {
      "id": "wh_2bcf87a2d548fed510cbd0a18295447a",
      "data": {
          "id": "kycid_27a1cbdb62aa4227ca927f9ecec228be",
          "state": null,
          "images": "v1/kyc/identities/images?reference_id=con_435ae32cea354976a8eb71a3b50e9f43",
          "address": "446 SUNSHINE AVE|YOUNGSTOWN, OH 44505",
          "contact": "cont_7bec50c4e8b4d2e1a47d584c31f5ef3d",
          "country": "US",
          "ewallet": "ewallet_9c1fa9be70674e2b4c4c90c7f8c86594",
          "dob_match": true,
          "id_number": "RQ299650",
          "last_name": "Doe",
          "created_at": 1694676742,
          "ewallet_id": "ewallet_9c1fa9be70674e2b4c4c90c7f8c86594",
          "first_name": "John",
          "name_match": true,
          "error_reason": null,
          "reference_id": "con_435ae32cea354976a8eb71a3b50e9f43",
          "country_match": true,
          "date_of_birth": "07/10/1949",
          "document_type": "DRIVING_LICENSE",
          "reject_reason": null,
          "request_source": "WEB_CAM",
          "additional_data": null,
          "expiration_date": "07/10/2024",
          "face_validation": true,
          "document_sub_type": null,
          "verification_status": "APPROVED"
      },
      "type": "IDENTITY_VERIFICATION",
      "status": "NEW",
      "created_at": 1694676919,
      "extended_timestamp": 1694676919354,
      "trigger_operation_id": "43def520-4cde-49b5-8cd7-c27c00cdec43"
  }
  ```