Receive updates, by webhooks, regarding account KYC and KYB status changes. Individual accounts use KYC and business accounts use KYB. Both flows publish the same account.kyc.* webhook events.

Overview

Event Name	Description
`account.kyc.submitted`	The account's KYC or KYB application was submitted and is pending review.
`account.kyc.approved`	The account's KYC or KYB application was approved.
`account.kyc.rejected`	The account's KYC or KYB application was rejected.

Object Structure Samples

{
  "Id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "Name": "account.kyc.submitted",
  "AccountId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "Data": {
    "AccountId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "ActivateStatus": "PendingApproval",
    "CreatedAt": "2025-06-01T00:00:00Z",
    "StatusChangedAt": "0001-01-01T00:00:00",
    "BusinessInformation": null,
    "PersonDetails": null
  },
  "CreateAtUtc": "2025-06-01T08:32:16.5312478Z"
}

{
  "Id": "9c858901-8a57-4791-81fe-4c455b099bc9",
  "Name": "account.kyc.approved",
  "AccountId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "Data": {
    "AccountId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "ActivateStatus": "Approved",
    "CreatedAt": "2025-06-01T08:30:00Z",
    "StatusChangedAt": "2025-06-03T10:15:42Z",
    "BusinessInformation": {
      "BusinessType": "Company",
      "BusinessName": "Acme Trading Ltd",
      "BusinessNumber": "512345678",
      "BusinessCountry": "IL",
      "BusinessAddress": {
        "CountryCode": "IL",
        "State": "",
        "City": "Tel Aviv",
        "Street": "Rothschild Boulevard",
        "HouseNumber": null,
        "ZipCode": "6688312"
      },
      "RegistrationAddress": {
        "CountryCode": "IL",
        "State": "",
        "City": "Tel Aviv",
        "Street": "Herzl Street",
        "HouseNumber": null,
        "ZipCode": "6511201"
      },
      "BusinessCategory": "Import and Export Trade",
      "DescriptionForServiceOrGoods": "Wholesale trading of consumer electronics and accessories."
    },
    "PersonDetails": [
      {
        "PersonId": "8c1a2b3d-4e5f-4a6b-9c7d-1e2f3a4b5c6d",
        "FirstName": "David",
        "LastName": "Cohen",
        "Email": "[email protected]",
        "PhoneNumber": "+972501234567",
        "BirthDate": "1985-03-22T00:00:00",
        "Address": {
          "CountryCode": "IL",
          "State": "",
          "City": "Tel Aviv",
          "Street": "Rothschild Boulevard",
          "HouseNumber": null,
          "ZipCode": "6688312"
        },
        "Citizenship": "IL",
        "RoleInBusiness": "AuthorizedPerson"
      }
    ]
  },
  "CreateAtUtc": "2025-06-03T10:15:43.1187654Z"
}

{
  "Id": "c56a4180-65aa-42ec-a945-5fd21dec0538",
  "Name": "account.kyc.rejected",
  "AccountId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "Data": {
    "AccountId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "ActivateStatus": "Declined",
    "CreatedAt": "2025-06-01T08:30:00Z",
    "StatusChangedAt": "2025-06-02T14:05:10Z",
    "BusinessInformation": {
      "BusinessType": "Company",
      "BusinessName": "Acme Trading Ltd",
      "BusinessNumber": "512345678",
      "BusinessCountry": "IL",
      "BusinessAddress": {
        "CountryCode": "IL",
        "State": "",
        "City": "Tel Aviv",
        "Street": "Rothschild Boulevard",
        "HouseNumber": null,
        "ZipCode": "6688312"
      },
      "RegistrationAddress": null,
      "BusinessCategory": "Import and Export Trade",
      "DescriptionForServiceOrGoods": null
    },
    "PersonDetails": [
      {
        "PersonId": "8c1a2b3d-4e5f-4a6b-9c7d-1e2f3a4b5c6d",
        "FirstName": "David",
        "LastName": "Cohen",
        "Email": "[email protected]",
        "PhoneNumber": "+972501234567",
        "BirthDate": "1985-03-22T00:00:00",
        "Address": {
          "CountryCode": "IL",
          "State": "",
          "City": "Tel Aviv",
          "Street": "Rothschild Boulevard",
          "HouseNumber": null,
          "ZipCode": "6688312"
        },
        "Citizenship": "IL",
        "RoleInBusiness": "AuthorizedPerson"
      }
    ]
  },
  "CreateAtUtc": "2025-06-02T14:05:11.8890231Z"
}

Data Object For KYC / KYB

Property	Type	Description
`AccountId`	`string (UUID)`	The unique identifier of the account whose KYC or KYB status changed.
`ActivateStatus`	`string`	The current verification status. Possible values are `PendingApproval`, `Approved`, and `Declined`.
`CreatedAt`	`string (ISO 8601 date-time)`	The date and time when the KYC or KYB process was created.
`StatusChangedAt`	`string (ISO 8601 date-time)`	The date and time when the verification status changed. For a submitted event, this may contain the default `DateTime` value when no status-change timestamp was assigned.
`BusinessInformation`	`object or null`	Business information associated with the account. Populated for business KYB events and `null` for individual KYC events. See Business Information Object.
`PersonDetails`	`array of objects or null`	People associated with the verification. For individual KYC, this may contain the applicant. For business KYB, it may contain authorized persons, directors, shareholders, or beneficial owners. See Person Details Object.

Business Information Object

Property	Type	Description
`BusinessType`	`string`	The legal structure of the business, for example `Company`, `SoleProprietor`, `Partnership`, `PublicCompany`, or `Association`.
`BusinessName`	`string`	The registered legal name of the business.
`BusinessNumber`	`string`	The official business registration number.
`BusinessCountry`	`string or null`	The ISO country code of the country in which the business operates.
`BusinessAddress`	`object or null`	The operating address of the business. See Address Object.
`RegistrationAddress`	`object or null`	The registered legal address of the business. See Address Object.
`BusinessCategory`	`string`	The business category or industry classification.
`DescriptionForServiceOrGoods`	`string or null`	A description of the products or services provided by the business.

Person Details Object

Property	Type	Description
`PersonId`	`string (UUID) or null`	The unique identifier of the person record.
`FirstName`	`string`	The person's first name.
`LastName`	`string`	The person's last name.
`Email`	`string`	The person's email address.
`PhoneNumber`	`string or null`	The person's phone number, including country code.
`BirthDate`	`string (ISO 8601 date-time) or null`	The person's date of birth.
`Address`	`object or null`	The person's residential address. See Address Object.
`Citizenship`	`string or null`	The ISO country code representing the person's citizenship.
`RoleInBusiness`	`string or null`	The person's role in relation to the business, for example `AuthorizedPerson`, `Director`, `Shareholder`, or `BeneficialOwner`.

Address Object

Property	Type	Description
`CountryCode`	`string`	The ISO country code of the address.
`State`	`string`	The state, province, or region of the address.
`City`	`string`	The city of the address.
`Street`	`string`	The street name of the address.
`HouseNumber`	`string or null`	The house or building number.
`ZipCode`	`string`	The postal or ZIP code.