Identity Verification (KYC)

Webhook Examples for Identity Verification (KYC)

Event Type: decision.approved

{
  "event_id": "3825badc-349c-40c6-b369-ce2b9b186a60",
  "resource": {
    "id": "decision_NTapRyLJ5JnwnyWF3FHoG3JC",
    "rel": {
      "url": "https://api.bynn.com/v1/decision/decision_NTapRyLJ5JnwnyWF3FHoG3JC"
    },
    "name": "AMRANI MYRIAM",
    "type": "decision",
    "entity": {
      "id": "entity_eeah4Rqm7HLB2cA81mQKUtbo",
      "rel": {
        "url": "https://api.bynn.com/v1/entities/entity_eeah4Rqm7HLB2cA81mQKUtbo"
      },
      "type": "entity",
      "reference": "",
      "created_at": "2025-06-12T14:59:17+01:00",
      "updated_at": "2025-06-12T14:59:28+01:00",
      "personal_info": {
        "full_name": "AMRANI MYRIAM",
        "height_cm": 162,
        "last_name": "AMRANI",
        "first_name": "MYRIAM",
        "date_of_birth": "1999-04-07",
        "entity_category": "individual",
        "nationality_country_id": "FR",
        "registration_country_id": "FR"
      },
      "entity_category": "individual"
    },
    "status": "accepted",
    "dossier": {
      "id": "dossier_7my2UZBDBUqLaAwJbeyxTcUc",
      "rel": {
        "url": "https://api.bynn.com/v1/dossiers/dossier_7my2UZBDBUqLaAwJbeyxTcUc"
      },
      "name": "AMRANI MYRIAM",
      "type": "dossier",
      "token": "4CCXK6FTX",
      "status": "approved",
      "reference": "",
      "created_at": "2025-06-12T14:59:17+01:00",
      "updated_at": "2025-06-12T14:59:33+01:00"
    },
    "reference": "",
    "risk_tags": [
      "document.security_checks"
    ],
    "created_at": "2025-06-12T14:59:33+01:00",
    "updated_at": "2025-06-12T14:59:33+01:00",
    "verification_url": "/v1/verifications/12df6045-3846-3e45-946a-14fa6136d78b",
    "identity_document": {
      "id": "id_doc_hU5G6v9L7FHwU84hcPLp1H6x",
      "rel": {
        "url": "https://api.bynn.com/v1/identity_document/id_doc_hU5G6v9L7FHwU84hcPLp1H6x"
      },
      "type": "identity_document",
      "person": {
        "full_name": "KESO MYRIAM",
        "last_name": "KESO",
        "first_name": "MYRIAM",
        "date_of_birth": "1999-04-07",
        "surname_and_given_names": "KESO MYRIAM"
      },
      "document": {
        "type": "passport",
        "number": "19KL54522",
        "address": {
          "full": "999 ALL BELVEDERE^13127 VITROLLES^FRANCE"
        },
        "mrz_data": "P<FRKESO<<MYRIAM<<<<<<<<<<<<<<<<<<<<<<<<<^19KL545223FRA9904075F2905202<<<<<<<<<<<<<<02",
        "mrz_type": "ID-3",
        "specimen": false,
        "tampered": false,
        "checksums": {
          "final": "2",
          "date_of_birth": "5",
          "optional_data": "0",
          "date_of_expiry": "2",
          "document_number": "3"
        },
        "height_cm": 162,
        "is_expired": false,
        "issue_date": "2019-05-21",
        "risk_score": 0,
        "valid_until": "2029-05-20",
        "document_name": "France - ePassport (2008-2013)",
        "nfc_validated": false,
        "issuing_country": "FR",
        "nationality_code": "FRA",
        "issuing_authority": "PREFECTURE DES BOUCHES-DU-^RHONE MARSEILLE",
        "document_class_code": "P",
        "forensics_completed": true,
        "nationality_country": "FR",
        "verification_status": "analyzed"
      },
      "entity_id": "entity_eeah4Rqm7HLB2cA81mQKUtbo",
      "dossier_id": "dossier_7my2UZBDBUqLaAwJbeyxTcUc",
      "verification_status": "analyzed"
    }
  },
  "created_at": "2025-06-12T14:59:33+01:00",
  "event_type": "decision.approved",
  "organization": {
    "id": "acct_vYir8us37earN8qjaeoNsHqC",
    "name": "Organization Ltd"
  }
}