Webhook Events

Learn about the different statuses an Aadhaar verification via OTP request can have.

We use webhooks to notify you about important events on your KYC verification. These webhooks contain details about the event such as changes that occurred and the resources impacted by the change.

We send webhooks as HTTP POST call to a URL configured by you. The webhook payload uses the JSON format.

Learn more about our Webhooks.

Available Events

The table below lists the various webhook events triggered when verifying Aadhaar via OTP.

Webhook EventsDescription
kycs.aadhaar.createdTriggered when the Send OTP API call is successfully made.
kycs.aadhaar.updatedTriggered when the Download Aadhaar Details API call is successfully made.

Sample Payload

KYCs Aadhaar Created

Triggered when the Aadhaar via OTP: Send OTP API call is successfully made.

{
  "id": "evl_Qsr3oSu0Y71asSNxlt2Gb1Z01",
  "object": "event",
  "name": "kycs.aadhaar.created",
  "is_sandbox": true,
  "data": {
    "object": {
      "id": "adh_6Zr0nsjOK8QxxyRqWmOQpt7Z4",
      "object": "aadhaar_verification",
      "aadhaar_number": "XXXXXXXX0989",
      "name": "Anil Reddy",
      "message": "OTP sent to registered mobile number",
      "status": "success",
      "remark": null,
      "merchant_reference_id": "1000989",
      "created_at": 1655281933,
      "is_sandbox": true
    }
  }
}

KYCs Aadhaar Updated

Triggered when the Aadhaar via OTP: Download Aadhar Details API call is successfully made.

{
  "id": "evl_HRjpC8YdzJOzsIqtYgnd7q6lS",
  "object": "event",
  "name": "kycs.aadhaar.updated",
  "is_sandbox": true,
  "data": {
    "object": {
      "id": "adh_6Zr0nsjOK8QxxyRqWmOQpt7Z4",
      "object": "aadhaar_verification",
      "message": "Aadhaar XML file downloaded successfully",
      "status": "success",
      "name": "Anil Reddy",
      "aadhaar_number": "XXXXXXXX0989",
      "date_of_birth": "1990-01-20",
      "gender": "M",
      "father_name": "Father",
      "address": "Address as per aadhaar records",
      "postal_code": "560035",
      "state": "Kerala",
      "state_code": "KL",
      "city": "bangalore urban",
      "remark": null,
      "merchant_reference_id": "1000989",
      "is_sandbox": true
    }
  }
}