# Verification Status

## Approved

`com.twilio.accountsecurity.verify.verification.approved`

Verification Status Approved events are compatible with Webhook and Kinesis sinks. To learn more, you can get started with the [Webhook](/docs/events/webhook-quickstart) or [Kinesis](/docs/events/eventstreams-quickstart) quickstarts and refer to the [product documentation](/docs/verify/verify-events).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.accountsecurity.verify.verification.approved",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/AccountSecurity.VerifyEventStreamEvent/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "account_sid" : "AC0000000000000000000000000000001",
    "service_sid" : "VA0000000000000000000000000000001",
    "verification_sid" : "VE0000000000000000000000000000001",
    "friendly_name" : "My verification service",
    "custom_code_enabled" : false,
    "custom_friendly_name" : "My verification service",
    "created_at" : "2025-01-01T00:00:00.000Z",
    "verified_at" : "2025-01-01T00:00:01.000Z",
    "to" : "+11234567890",
    "verification_status" : "APPROVED",
    "country" : "US",
    "code_length" : 6,
    "send_code_attempts" : {
      "count" : 1,
      "attempts" : [
        {
          "time" : "2025-01-01T00:00:00.000Z",
          "channel" : "SMS",
          "attempt_sid" : "VL0000000000000000000000000000001",
          "delivery_status" : "UNDELIVERED",
          "error_code" : "30004",
          "locale" : "es"
        }
      ]
    },
    "check_attempts" : {
      "count" : 0,
      "attempts" : [
        {
          "time" : "2025-01-01T00:00:00.000Z",
          "status" : "SUCCESS"
        }
      ]
    },
    "expired_at" : "2025-01-01T00:10:00.000Z"
  }
}
```

**Versions**

#### v2 (latest)

> \[!NOTE]
>
> v2 only contains updates to the schema metadata. In other words, there are no new fields between v1 and v2.

* `string` **account\_sid** (required). The SID of the Account that created the Verification resource.
* `string` **service\_sid** (required). The SID of the Service used to generate the Verification resource.
* `string` **verification\_sid** (required). The SID created to uniquely identify the Verification resource.
* `string` **friendly\_name** (required). A custom user defined string to describe the verification service.
* `boolean` **custom\_code\_enabled** (required). A boolean value to define whether verifications are allowed to be sent with a custom code instead of a randomly generated one.
* `string` **custom\_friendly\_name**. An optional custom user defined string to describe the verification service.
* `string` **created\_at** (required). The date when the resource was created, given in ISO 8601 format.
* `string` **verified\_at**. The date when the resource was verified, given in ISO 8601 format.
* `string` **to** (required). Destination of a verification. It is phone number in E.164 format.
* `string` **verification\_status** (required). The status of the verification.
* `string` **country** (required). Country code.
* `integer` **code\_length**. The length of the generated verification code.
* `object` **send\_code\_attempts** (required). SendCodeAttempts definition.
  * `integer` **count** (required). The number of attempts sent as a part of a verification.
  * `object[]` **attempts**. An array of objects containing information about the each attempt.
    * `string` **time** (required). The date that the Attempt was created, given in ISO 8601 format.
    * `string` **channel** (required). A string specifying the communication channel used for the verification attempt, i.e. SMS, CALL, WHATSAPP etc.
    * `string` **attempt\_sid** (required). The SID that uniquely identifies the delivery attempt resource.
    * `string` **delivery\_status**. The delivery status of the attempt. Possible values can be Accepted, Queued, Sent, Failed, Delivered & Undelivered.
    * `string` **error\_code**. The error code generated from a Verification send attempt.
    * `string` **locale** (required). The locale will automatically resolve based on phone number country code for SMS, Call and WhatsApp channel verifications.
* `object` **check\_attempts** (required). CheckAttempts definition.
  * `integer` **count** (required). The number of times verification was checked.
  * `object[]` **attempts**. An array of objects containing information about the each attempt.
    * `string` **time** (required). The date that the Verification Attempt was checked, given in ISO 8601 format.
    * `string` **status** (required). The status of the Verification Check Attempt check. Possible values can be SUCCESS or FAILURE.
* `string` **expired\_at**. The date when the resource will expire, given in ISO 8601 format.

The full specification for version 2 is also available as a [JSON schema](https://events-schemas.twilio.com/AccountSecurity.VerifyEventStreamEvent/2).

#### v1

* `string` **account\_sid** (required). The SID of the Account that created the Verification resource.
* `string` **service\_sid** (required). The SID of the Service used to generate the Verification resource.
* `string` **verification\_sid** (required). The SID created to uniquely identify the Verification resource.
* `string` **friendly\_name** (required). A custom user defined string to describe the verification service.
* `boolean` **custom\_code\_enabled** (required). A boolean value to define whether verifications are allowed to be sent with a custom code instead of a randomly generated one.
* `string` **custom\_friendly\_name**. An optional custom user defined string to describe the verification service.
* `string` **created\_at** (required). The date when the resource was created, given in ISO 8601 format.
* `string` **verified\_at**. The date when the resource was verified, given in ISO 8601 format.
* `string` **to** (required). Destination of a verification. It is phone number in E.164 format.
* `string` **verification\_status** (required). The status of the verification.
* `string` **country** (required). Country code.
* `integer` **code\_length**. The length of the generated verification code.
* `object` **send\_code\_attempts** (required). SendCodeAttempts definition.
  * `integer` **count** (required). The number of attempts sent as a part of a verification.
  * `object[]` **attempts**. An array of objects containing information about the each attempt.
    * `string` **time** (required). The date that the Attempt was created, given in ISO 8601 format.
    * `string` **channel** (required). A string specifying the communication channel used for the verification attempt, i.e. SMS, CALL, WHATSAPP etc.
    * `string` **attempt\_sid** (required). The SID that uniquely identifies the delivery attempt resource.
    * `string` **delivery\_status**. The delivery status of the attempt. Possible values can be Accepted, Queued, Sent, Failed, Delivered & Undelivered.
    * `string` **error\_code**. The error code generated from a Verification send attempt.
    * `string` **locale** (required). The locale will automatically resolve based on phone number country code for SMS, Call and WhatsApp channel verifications.
* `object` **check\_attempts** (required). CheckAttempts definition.
  * `integer` **count** (required). The number of times verification was checked.
  * `object[]` **attempts**. An array of objects containing information about the each attempt.
    * `string` **time** (required). The date that the Verification Attempt was checked, given in ISO 8601 format.
    * `string` **status** (required). The status of the Verification Check Attempt check. Possible values can be SUCCESS or FAILURE.
* `string` **expired\_at**. The date when the resource will expire, given in ISO 8601 format.

The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/AccountSecurity.VerifyEventStreamEvent/1).

## Canceled

`com.twilio.accountsecurity.verify.verification.canceled`

Verification Status Canceled events are compatible with Webhook and Kinesis sinks. To learn more, you can get started with the [Webhook](/docs/events/webhook-quickstart) or [Kinesis](/docs/events/eventstreams-quickstart) quickstarts and refer to the [product documentation](/docs/verify/verify-events).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.accountsecurity.verify.verification.canceled",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/AccountSecurity.VerifyEventStreamEvent/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "account_sid" : "AC0000000000000000000000000000001",
    "service_sid" : "VA0000000000000000000000000000001",
    "verification_sid" : "VE0000000000000000000000000000001",
    "friendly_name" : "My verification service",
    "custom_code_enabled" : false,
    "custom_friendly_name" : "My verification service",
    "created_at" : "2025-01-01T00:00:00.000Z",
    "verified_at" : "2025-01-01T00:00:01.000Z",
    "to" : "+11234567890",
    "verification_status" : "APPROVED",
    "country" : "US",
    "code_length" : 6,
    "send_code_attempts" : {
      "count" : 1,
      "attempts" : [
        {
          "time" : "2025-01-01T00:00:00.000Z",
          "channel" : "SMS",
          "attempt_sid" : "VL0000000000000000000000000000001",
          "delivery_status" : "UNDELIVERED",
          "error_code" : "30004",
          "locale" : "es"
        }
      ]
    },
    "check_attempts" : {
      "count" : 0,
      "attempts" : [
        {
          "time" : "2025-01-01T00:00:00.000Z",
          "status" : "SUCCESS"
        }
      ]
    },
    "expired_at" : "2025-01-01T00:10:00.000Z"
  }
}
```

**Versions**

#### v2 (latest)

> \[!NOTE]
>
> v2 only contains updates to the schema metadata. In other words, there are no new fields between v1 and v2.

* `string` **account\_sid** (required). The SID of the Account that created the Verification resource.
* `string` **service\_sid** (required). The SID of the Service used to generate the Verification resource.
* `string` **verification\_sid** (required). The SID created to uniquely identify the Verification resource.
* `string` **friendly\_name** (required). A custom user defined string to describe the verification service.
* `boolean` **custom\_code\_enabled** (required). A boolean value to define whether verifications are allowed to be sent with a custom code instead of a randomly generated one.
* `string` **custom\_friendly\_name**. An optional custom user defined string to describe the verification service.
* `string` **created\_at** (required). The date when the resource was created, given in ISO 8601 format.
* `string` **verified\_at**. The date when the resource was verified, given in ISO 8601 format.
* `string` **to** (required). Destination of a verification. It is phone number in E.164 format.
* `string` **verification\_status** (required). The status of the verification.
* `string` **country** (required). Country code.
* `integer` **code\_length**. The length of the generated verification code.
* `object` **send\_code\_attempts** (required). SendCodeAttempts definition.
  * `integer` **count** (required). The number of attempts sent as a part of a verification.
  * `object[]` **attempts**. An array of objects containing information about the each attempt.
    * `string` **time** (required). The date that the Attempt was created, given in ISO 8601 format.
    * `string` **channel** (required). A string specifying the communication channel used for the verification attempt, i.e. SMS, CALL, WHATSAPP etc.
    * `string` **attempt\_sid** (required). The SID that uniquely identifies the delivery attempt resource.
    * `string` **delivery\_status**. The delivery status of the attempt. Possible values can be Accepted, Queued, Sent, Failed, Delivered & Undelivered.
    * `string` **error\_code**. The error code generated from a Verification send attempt.
    * `string` **locale** (required). The locale will automatically resolve based on phone number country code for SMS, Call and WhatsApp channel verifications.
* `object` **check\_attempts** (required). CheckAttempts definition.
  * `integer` **count** (required). The number of times verification was checked.
  * `object[]` **attempts**. An array of objects containing information about the each attempt.
    * `string` **time** (required). The date that the Verification Attempt was checked, given in ISO 8601 format.
    * `string` **status** (required). The status of the Verification Check Attempt check. Possible values can be SUCCESS or FAILURE.
* `string` **expired\_at**. The date when the resource will expire, given in ISO 8601 format.

The full specification for version 2 is also available as a [JSON schema](https://events-schemas.twilio.com/AccountSecurity.VerifyEventStreamEvent/2).

#### v1

* `string` **account\_sid** (required). The SID of the Account that created the Verification resource.
* `string` **service\_sid** (required). The SID of the Service used to generate the Verification resource.
* `string` **verification\_sid** (required). The SID created to uniquely identify the Verification resource.
* `string` **friendly\_name** (required). A custom user defined string to describe the verification service.
* `boolean` **custom\_code\_enabled** (required). A boolean value to define whether verifications are allowed to be sent with a custom code instead of a randomly generated one.
* `string` **custom\_friendly\_name**. An optional custom user defined string to describe the verification service.
* `string` **created\_at** (required). The date when the resource was created, given in ISO 8601 format.
* `string` **verified\_at**. The date when the resource was verified, given in ISO 8601 format.
* `string` **to** (required). Destination of a verification. It is phone number in E.164 format.
* `string` **verification\_status** (required). The status of the verification.
* `string` **country** (required). Country code.
* `integer` **code\_length**. The length of the generated verification code.
* `object` **send\_code\_attempts** (required). SendCodeAttempts definition.
  * `integer` **count** (required). The number of attempts sent as a part of a verification.
  * `object[]` **attempts**. An array of objects containing information about the each attempt.
    * `string` **time** (required). The date that the Attempt was created, given in ISO 8601 format.
    * `string` **channel** (required). A string specifying the communication channel used for the verification attempt, i.e. SMS, CALL, WHATSAPP etc.
    * `string` **attempt\_sid** (required). The SID that uniquely identifies the delivery attempt resource.
    * `string` **delivery\_status**. The delivery status of the attempt. Possible values can be Accepted, Queued, Sent, Failed, Delivered & Undelivered.
    * `string` **error\_code**. The error code generated from a Verification send attempt.
    * `string` **locale** (required). The locale will automatically resolve based on phone number country code for SMS, Call and WhatsApp channel verifications.
* `object` **check\_attempts** (required). CheckAttempts definition.
  * `integer` **count** (required). The number of times verification was checked.
  * `object[]` **attempts**. An array of objects containing information about the each attempt.
    * `string` **time** (required). The date that the Verification Attempt was checked, given in ISO 8601 format.
    * `string` **status** (required). The status of the Verification Check Attempt check. Possible values can be SUCCESS or FAILURE.
* `string` **expired\_at**. The date when the resource will expire, given in ISO 8601 format.

The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/AccountSecurity.VerifyEventStreamEvent/1).

## Expired

`com.twilio.accountsecurity.verify.verification.expired`

Verification Status Expired events are compatible with Webhook and Kinesis sinks. To learn more, you can get started with the [Webhook](/docs/events/webhook-quickstart) or [Kinesis](/docs/events/eventstreams-quickstart) quickstarts and refer to the [product documentation](/docs/verify/verify-events).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.accountsecurity.verify.verification.expired",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/AccountSecurity.VerifyEventStreamEvent/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "account_sid" : "AC0000000000000000000000000000001",
    "service_sid" : "VA0000000000000000000000000000001",
    "verification_sid" : "VE0000000000000000000000000000001",
    "friendly_name" : "My verification service",
    "custom_code_enabled" : false,
    "custom_friendly_name" : "My verification service",
    "created_at" : "2025-01-01T00:00:00.000Z",
    "verified_at" : "2025-01-01T00:00:01.000Z",
    "to" : "+11234567890",
    "verification_status" : "APPROVED",
    "country" : "US",
    "code_length" : 6,
    "send_code_attempts" : {
      "count" : 1,
      "attempts" : [
        {
          "time" : "2025-01-01T00:00:00.000Z",
          "channel" : "SMS",
          "attempt_sid" : "VL0000000000000000000000000000001",
          "delivery_status" : "UNDELIVERED",
          "error_code" : "30004",
          "locale" : "es"
        }
      ]
    },
    "check_attempts" : {
      "count" : 0,
      "attempts" : [
        {
          "time" : "2025-01-01T00:00:00.000Z",
          "status" : "SUCCESS"
        }
      ]
    },
    "expired_at" : "2025-01-01T00:10:00.000Z"
  }
}
```

**Versions**

#### v2 (latest)

> \[!NOTE]
>
> v2 only contains updates to the schema metadata. In other words, there are no new fields between v1 and v2.

* `string` **account\_sid** (required). The SID of the Account that created the Verification resource.
* `string` **service\_sid** (required). The SID of the Service used to generate the Verification resource.
* `string` **verification\_sid** (required). The SID created to uniquely identify the Verification resource.
* `string` **friendly\_name** (required). A custom user defined string to describe the verification service.
* `boolean` **custom\_code\_enabled** (required). A boolean value to define whether verifications are allowed to be sent with a custom code instead of a randomly generated one.
* `string` **custom\_friendly\_name**. An optional custom user defined string to describe the verification service.
* `string` **created\_at** (required). The date when the resource was created, given in ISO 8601 format.
* `string` **verified\_at**. The date when the resource was verified, given in ISO 8601 format.
* `string` **to** (required). Destination of a verification. It is phone number in E.164 format.
* `string` **verification\_status** (required). The status of the verification.
* `string` **country** (required). Country code.
* `integer` **code\_length**. The length of the generated verification code.
* `object` **send\_code\_attempts** (required). SendCodeAttempts definition.
  * `integer` **count** (required). The number of attempts sent as a part of a verification.
  * `object[]` **attempts**. An array of objects containing information about the each attempt.
    * `string` **time** (required). The date that the Attempt was created, given in ISO 8601 format.
    * `string` **channel** (required). A string specifying the communication channel used for the verification attempt, i.e. SMS, CALL, WHATSAPP etc.
    * `string` **attempt\_sid** (required). The SID that uniquely identifies the delivery attempt resource.
    * `string` **delivery\_status**. The delivery status of the attempt. Possible values can be Accepted, Queued, Sent, Failed, Delivered & Undelivered.
    * `string` **error\_code**. The error code generated from a Verification send attempt.
    * `string` **locale** (required). The locale will automatically resolve based on phone number country code for SMS, Call and WhatsApp channel verifications.
* `object` **check\_attempts** (required). CheckAttempts definition.
  * `integer` **count** (required). The number of times verification was checked.
  * `object[]` **attempts**. An array of objects containing information about the each attempt.
    * `string` **time** (required). The date that the Verification Attempt was checked, given in ISO 8601 format.
    * `string` **status** (required). The status of the Verification Check Attempt check. Possible values can be SUCCESS or FAILURE.
* `string` **expired\_at**. The date when the resource will expire, given in ISO 8601 format.

The full specification for version 2 is also available as a [JSON schema](https://events-schemas.twilio.com/AccountSecurity.VerifyEventStreamEvent/2).

#### v1

* `string` **account\_sid** (required). The SID of the Account that created the Verification resource.
* `string` **service\_sid** (required). The SID of the Service used to generate the Verification resource.
* `string` **verification\_sid** (required). The SID created to uniquely identify the Verification resource.
* `string` **friendly\_name** (required). A custom user defined string to describe the verification service.
* `boolean` **custom\_code\_enabled** (required). A boolean value to define whether verifications are allowed to be sent with a custom code instead of a randomly generated one.
* `string` **custom\_friendly\_name**. An optional custom user defined string to describe the verification service.
* `string` **created\_at** (required). The date when the resource was created, given in ISO 8601 format.
* `string` **verified\_at**. The date when the resource was verified, given in ISO 8601 format.
* `string` **to** (required). Destination of a verification. It is phone number in E.164 format.
* `string` **verification\_status** (required). The status of the verification.
* `string` **country** (required). Country code.
* `integer` **code\_length**. The length of the generated verification code.
* `object` **send\_code\_attempts** (required). SendCodeAttempts definition.
  * `integer` **count** (required). The number of attempts sent as a part of a verification.
  * `object[]` **attempts**. An array of objects containing information about the each attempt.
    * `string` **time** (required). The date that the Attempt was created, given in ISO 8601 format.
    * `string` **channel** (required). A string specifying the communication channel used for the verification attempt, i.e. SMS, CALL, WHATSAPP etc.
    * `string` **attempt\_sid** (required). The SID that uniquely identifies the delivery attempt resource.
    * `string` **delivery\_status**. The delivery status of the attempt. Possible values can be Accepted, Queued, Sent, Failed, Delivered & Undelivered.
    * `string` **error\_code**. The error code generated from a Verification send attempt.
    * `string` **locale** (required). The locale will automatically resolve based on phone number country code for SMS, Call and WhatsApp channel verifications.
* `object` **check\_attempts** (required). CheckAttempts definition.
  * `integer` **count** (required). The number of times verification was checked.
  * `object[]` **attempts**. An array of objects containing information about the each attempt.
    * `string` **time** (required). The date that the Verification Attempt was checked, given in ISO 8601 format.
    * `string` **status** (required). The status of the Verification Check Attempt check. Possible values can be SUCCESS or FAILURE.
* `string` **expired\_at**. The date when the resource will expire, given in ISO 8601 format.

The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/AccountSecurity.VerifyEventStreamEvent/1).

## Max Attempts Reached

`com.twilio.accountsecurity.verify.verification.max-attempts-reached`

Verification Status Max Attempts Reached events are compatible with Webhook and Kinesis sinks. To learn more, you can get started with the [Webhook](/docs/events/webhook-quickstart) or [Kinesis](/docs/events/eventstreams-quickstart) quickstarts and refer to the [product documentation](/docs/verify/verify-events).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.accountsecurity.verify.verification.max-attempts-reached",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/AccountSecurity.VerifyEventStreamEvent/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "account_sid" : "AC0000000000000000000000000000001",
    "service_sid" : "VA0000000000000000000000000000001",
    "verification_sid" : "VE0000000000000000000000000000001",
    "friendly_name" : "My verification service",
    "custom_code_enabled" : false,
    "custom_friendly_name" : "My verification service",
    "created_at" : "2025-01-01T00:00:00.000Z",
    "verified_at" : "2025-01-01T00:00:01.000Z",
    "to" : "+11234567890",
    "verification_status" : "APPROVED",
    "country" : "US",
    "code_length" : 6,
    "send_code_attempts" : {
      "count" : 1,
      "attempts" : [
        {
          "time" : "2025-01-01T00:00:00.000Z",
          "channel" : "SMS",
          "attempt_sid" : "VL0000000000000000000000000000001",
          "delivery_status" : "UNDELIVERED",
          "error_code" : "30004",
          "locale" : "es"
        }
      ]
    },
    "check_attempts" : {
      "count" : 0,
      "attempts" : [
        {
          "time" : "2025-01-01T00:00:00.000Z",
          "status" : "SUCCESS"
        }
      ]
    },
    "expired_at" : "2025-01-01T00:10:00.000Z"
  }
}
```

**Versions**

#### v2 (latest)

> \[!NOTE]
>
> v2 only contains updates to the schema metadata. In other words, there are no new fields between v1 and v2.

* `string` **account\_sid** (required). The SID of the Account that created the Verification resource.
* `string` **service\_sid** (required). The SID of the Service used to generate the Verification resource.
* `string` **verification\_sid** (required). The SID created to uniquely identify the Verification resource.
* `string` **friendly\_name** (required). A custom user defined string to describe the verification service.
* `boolean` **custom\_code\_enabled** (required). A boolean value to define whether verifications are allowed to be sent with a custom code instead of a randomly generated one.
* `string` **custom\_friendly\_name**. An optional custom user defined string to describe the verification service.
* `string` **created\_at** (required). The date when the resource was created, given in ISO 8601 format.
* `string` **verified\_at**. The date when the resource was verified, given in ISO 8601 format.
* `string` **to** (required). Destination of a verification. It is phone number in E.164 format.
* `string` **verification\_status** (required). The status of the verification.
* `string` **country** (required). Country code.
* `integer` **code\_length**. The length of the generated verification code.
* `object` **send\_code\_attempts** (required). SendCodeAttempts definition.
  * `integer` **count** (required). The number of attempts sent as a part of a verification.
  * `object[]` **attempts**. An array of objects containing information about the each attempt.
    * `string` **time** (required). The date that the Attempt was created, given in ISO 8601 format.
    * `string` **channel** (required). A string specifying the communication channel used for the verification attempt, i.e. SMS, CALL, WHATSAPP etc.
    * `string` **attempt\_sid** (required). The SID that uniquely identifies the delivery attempt resource.
    * `string` **delivery\_status**. The delivery status of the attempt. Possible values can be Accepted, Queued, Sent, Failed, Delivered & Undelivered.
    * `string` **error\_code**. The error code generated from a Verification send attempt.
    * `string` **locale** (required). The locale will automatically resolve based on phone number country code for SMS, Call and WhatsApp channel verifications.
* `object` **check\_attempts** (required). CheckAttempts definition.
  * `integer` **count** (required). The number of times verification was checked.
  * `object[]` **attempts**. An array of objects containing information about the each attempt.
    * `string` **time** (required). The date that the Verification Attempt was checked, given in ISO 8601 format.
    * `string` **status** (required). The status of the Verification Check Attempt check. Possible values can be SUCCESS or FAILURE.
* `string` **expired\_at**. The date when the resource will expire, given in ISO 8601 format.

The full specification for version 2 is also available as a [JSON schema](https://events-schemas.twilio.com/AccountSecurity.VerifyEventStreamEvent/2).

#### v1

* `string` **account\_sid** (required). The SID of the Account that created the Verification resource.
* `string` **service\_sid** (required). The SID of the Service used to generate the Verification resource.
* `string` **verification\_sid** (required). The SID created to uniquely identify the Verification resource.
* `string` **friendly\_name** (required). A custom user defined string to describe the verification service.
* `boolean` **custom\_code\_enabled** (required). A boolean value to define whether verifications are allowed to be sent with a custom code instead of a randomly generated one.
* `string` **custom\_friendly\_name**. An optional custom user defined string to describe the verification service.
* `string` **created\_at** (required). The date when the resource was created, given in ISO 8601 format.
* `string` **verified\_at**. The date when the resource was verified, given in ISO 8601 format.
* `string` **to** (required). Destination of a verification. It is phone number in E.164 format.
* `string` **verification\_status** (required). The status of the verification.
* `string` **country** (required). Country code.
* `integer` **code\_length**. The length of the generated verification code.
* `object` **send\_code\_attempts** (required). SendCodeAttempts definition.
  * `integer` **count** (required). The number of attempts sent as a part of a verification.
  * `object[]` **attempts**. An array of objects containing information about the each attempt.
    * `string` **time** (required). The date that the Attempt was created, given in ISO 8601 format.
    * `string` **channel** (required). A string specifying the communication channel used for the verification attempt, i.e. SMS, CALL, WHATSAPP etc.
    * `string` **attempt\_sid** (required). The SID that uniquely identifies the delivery attempt resource.
    * `string` **delivery\_status**. The delivery status of the attempt. Possible values can be Accepted, Queued, Sent, Failed, Delivered & Undelivered.
    * `string` **error\_code**. The error code generated from a Verification send attempt.
    * `string` **locale** (required). The locale will automatically resolve based on phone number country code for SMS, Call and WhatsApp channel verifications.
* `object` **check\_attempts** (required). CheckAttempts definition.
  * `integer` **count** (required). The number of times verification was checked.
  * `object[]` **attempts**. An array of objects containing information about the each attempt.
    * `string` **time** (required). The date that the Verification Attempt was checked, given in ISO 8601 format.
    * `string` **status** (required). The status of the Verification Check Attempt check. Possible values can be SUCCESS or FAILURE.
* `string` **expired\_at**. The date when the resource will expire, given in ISO 8601 format.

The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/AccountSecurity.VerifyEventStreamEvent/1).

## Pending

`com.twilio.accountsecurity.verify.verification.pending`

Verification Status Pending events are compatible with Webhook and Kinesis sinks. To learn more, you can get started with the [Webhook](/docs/events/webhook-quickstart) or [Kinesis](/docs/events/eventstreams-quickstart) quickstarts and refer to the [product documentation](/docs/verify/verify-events).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.accountsecurity.verify.verification.pending",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/AccountSecurity.VerifyEventStreamEvent/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "account_sid" : "AC0000000000000000000000000000001",
    "service_sid" : "VA0000000000000000000000000000001",
    "verification_sid" : "VE0000000000000000000000000000001",
    "friendly_name" : "My verification service",
    "custom_code_enabled" : false,
    "custom_friendly_name" : "My verification service",
    "created_at" : "2025-01-01T00:00:00.000Z",
    "verified_at" : "2025-01-01T00:00:01.000Z",
    "to" : "+11234567890",
    "verification_status" : "APPROVED",
    "country" : "US",
    "code_length" : 6,
    "send_code_attempts" : {
      "count" : 1,
      "attempts" : [
        {
          "time" : "2025-01-01T00:00:00.000Z",
          "channel" : "SMS",
          "attempt_sid" : "VL0000000000000000000000000000001",
          "delivery_status" : "UNDELIVERED",
          "error_code" : "30004",
          "locale" : "es"
        }
      ]
    },
    "check_attempts" : {
      "count" : 0,
      "attempts" : [
        {
          "time" : "2025-01-01T00:00:00.000Z",
          "status" : "SUCCESS"
        }
      ]
    },
    "expired_at" : "2025-01-01T00:10:00.000Z"
  }
}
```

**Versions**

#### v2 (latest)

> \[!NOTE]
>
> v2 only contains updates to the schema metadata. In other words, there are no new fields between v1 and v2.

* `string` **account\_sid** (required). The SID of the Account that created the Verification resource.
* `string` **service\_sid** (required). The SID of the Service used to generate the Verification resource.
* `string` **verification\_sid** (required). The SID created to uniquely identify the Verification resource.
* `string` **friendly\_name** (required). A custom user defined string to describe the verification service.
* `boolean` **custom\_code\_enabled** (required). A boolean value to define whether verifications are allowed to be sent with a custom code instead of a randomly generated one.
* `string` **custom\_friendly\_name**. An optional custom user defined string to describe the verification service.
* `string` **created\_at** (required). The date when the resource was created, given in ISO 8601 format.
* `string` **verified\_at**. The date when the resource was verified, given in ISO 8601 format.
* `string` **to** (required). Destination of a verification. It is phone number in E.164 format.
* `string` **verification\_status** (required). The status of the verification.
* `string` **country** (required). Country code.
* `integer` **code\_length**. The length of the generated verification code.
* `object` **send\_code\_attempts** (required). SendCodeAttempts definition.
  * `integer` **count** (required). The number of attempts sent as a part of a verification.
  * `object[]` **attempts**. An array of objects containing information about the each attempt.
    * `string` **time** (required). The date that the Attempt was created, given in ISO 8601 format.
    * `string` **channel** (required). A string specifying the communication channel used for the verification attempt, i.e. SMS, CALL, WHATSAPP etc.
    * `string` **attempt\_sid** (required). The SID that uniquely identifies the delivery attempt resource.
    * `string` **delivery\_status**. The delivery status of the attempt. Possible values can be Accepted, Queued, Sent, Failed, Delivered & Undelivered.
    * `string` **error\_code**. The error code generated from a Verification send attempt.
    * `string` **locale** (required). The locale will automatically resolve based on phone number country code for SMS, Call and WhatsApp channel verifications.
* `object` **check\_attempts** (required). CheckAttempts definition.
  * `integer` **count** (required). The number of times verification was checked.
  * `object[]` **attempts**. An array of objects containing information about the each attempt.
    * `string` **time** (required). The date that the Verification Attempt was checked, given in ISO 8601 format.
    * `string` **status** (required). The status of the Verification Check Attempt check. Possible values can be SUCCESS or FAILURE.
* `string` **expired\_at**. The date when the resource will expire, given in ISO 8601 format.

The full specification for version 2 is also available as a [JSON schema](https://events-schemas.twilio.com/AccountSecurity.VerifyEventStreamEvent/2).

#### v1

* `string` **account\_sid** (required). The SID of the Account that created the Verification resource.
* `string` **service\_sid** (required). The SID of the Service used to generate the Verification resource.
* `string` **verification\_sid** (required). The SID created to uniquely identify the Verification resource.
* `string` **friendly\_name** (required). A custom user defined string to describe the verification service.
* `boolean` **custom\_code\_enabled** (required). A boolean value to define whether verifications are allowed to be sent with a custom code instead of a randomly generated one.
* `string` **custom\_friendly\_name**. An optional custom user defined string to describe the verification service.
* `string` **created\_at** (required). The date when the resource was created, given in ISO 8601 format.
* `string` **verified\_at**. The date when the resource was verified, given in ISO 8601 format.
* `string` **to** (required). Destination of a verification. It is phone number in E.164 format.
* `string` **verification\_status** (required). The status of the verification.
* `string` **country** (required). Country code.
* `integer` **code\_length**. The length of the generated verification code.
* `object` **send\_code\_attempts** (required). SendCodeAttempts definition.
  * `integer` **count** (required). The number of attempts sent as a part of a verification.
  * `object[]` **attempts**. An array of objects containing information about the each attempt.
    * `string` **time** (required). The date that the Attempt was created, given in ISO 8601 format.
    * `string` **channel** (required). A string specifying the communication channel used for the verification attempt, i.e. SMS, CALL, WHATSAPP etc.
    * `string` **attempt\_sid** (required). The SID that uniquely identifies the delivery attempt resource.
    * `string` **delivery\_status**. The delivery status of the attempt. Possible values can be Accepted, Queued, Sent, Failed, Delivered & Undelivered.
    * `string` **error\_code**. The error code generated from a Verification send attempt.
    * `string` **locale** (required). The locale will automatically resolve based on phone number country code for SMS, Call and WhatsApp channel verifications.
* `object` **check\_attempts** (required). CheckAttempts definition.
  * `integer` **count** (required). The number of times verification was checked.
  * `object[]` **attempts**. An array of objects containing information about the each attempt.
    * `string` **time** (required). The date that the Verification Attempt was checked, given in ISO 8601 format.
    * `string` **status** (required). The status of the Verification Check Attempt check. Possible values can be SUCCESS or FAILURE.
* `string` **expired\_at**. The date when the resource will expire, given in ISO 8601 format.

The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/AccountSecurity.VerifyEventStreamEvent/1).