# Message Status

## Delivered

`com.twilio.accountsecurity.verify.message.delivered`

Message Status Delivered 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.message.delivered",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/AccountSecurity.MessageStatusEvent/1",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "created_at" : "2025-01-01T00:00:00.000Z",
    "account_sid" : "AC0000000000000000000000000000001",
    "service_sid" : "VA0000000000000000000000000000001",
    "verification_sid" : "VE0000000000000000000000000000001",
    "attempt_sid" : "VL0000000000000000000000000000001",
    "error_code" : "",
    "channel" : "SMS",
    "message_status" : "DELIVERED",
    "has_fallback" : false,
    "is_fallback" : false,
    "mnc" : "460",
    "mcc" : "05",
    "to" : "+919999999999",
    "number_segments" : 2
  }
}
```

**Versions**

#### v1 (latest)

* `string` **created\_at** (required). The date when the attempt was created, given in ISO 8601 format.
* `string` **account\_sid** (required). Unique SID that identifies the Twilio account.
* `string` **service\_sid** (required). Unique SID that identifies the Verify service.
* `string` **verification\_sid** (required). Unique SID identifying the verification.
* `string` **attempt\_sid** (required). SID of the specific attempt used for delivering the verification.
* `string` **error\_code**. Error code returned in case the delivery failed; empty if successful.
* `string` **channel** (required). Channel used for verification such as SMS.
* `string` **message\_status** (required). Message status that the verification message returns, such as `DELIVERED` or `FAILED`.
* `boolean` **has\_fallback**. Flag that Indicates if a fallback channel was enabled.
* `boolean` **is\_fallback**. Flag that Indicates if the current verification is a fallback attempt.
* `string` **mnc**. Mobile Network Code that identifies the mobile carrier.
* `string` **mcc**. Mobile Country Code that identifies the country of the carrier.
* `string` **to** (required). Destination phone number expressed in E.164 format.
* `integer` **number\_segments**. Number of SMS segments used to deliver the verification message.

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

## Failed

`com.twilio.accountsecurity.verify.message.failed`

Message Status Failed 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.message.failed",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/AccountSecurity.MessageStatusEvent/1",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "created_at" : "2025-01-01T00:00:00.000Z",
    "account_sid" : "AC0000000000000000000000000000001",
    "service_sid" : "VA0000000000000000000000000000001",
    "verification_sid" : "VE0000000000000000000000000000001",
    "attempt_sid" : "VL0000000000000000000000000000001",
    "error_code" : "",
    "channel" : "SMS",
    "message_status" : "DELIVERED",
    "has_fallback" : false,
    "is_fallback" : false,
    "mnc" : "460",
    "mcc" : "05",
    "to" : "+919999999999",
    "number_segments" : 2
  }
}
```

**Versions**

#### v1 (latest)

* `string` **created\_at** (required). The date when the attempt was created, given in ISO 8601 format.
* `string` **account\_sid** (required). Unique SID that identifies the Twilio account.
* `string` **service\_sid** (required). Unique SID that identifies the Verify service.
* `string` **verification\_sid** (required). Unique SID identifying the verification.
* `string` **attempt\_sid** (required). SID of the specific attempt used for delivering the verification.
* `string` **error\_code**. Error code returned in case the delivery failed; empty if successful.
* `string` **channel** (required). Channel used for verification such as SMS.
* `string` **message\_status** (required). Message status that the verification message returns, such as `DELIVERED` or `FAILED`.
* `boolean` **has\_fallback**. Flag that Indicates if a fallback channel was enabled.
* `boolean` **is\_fallback**. Flag that Indicates if the current verification is a fallback attempt.
* `string` **mnc**. Mobile Network Code that identifies the mobile carrier.
* `string` **mcc**. Mobile Country Code that identifies the country of the carrier.
* `string` **to** (required). Destination phone number expressed in E.164 format.
* `integer` **number\_segments**. Number of SMS segments used to deliver the verification message.

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

## Read

`com.twilio.accountsecurity.verify.message.read`

Message Status Read 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.message.read",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/AccountSecurity.MessageStatusEvent/1",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "created_at" : "2025-01-01T00:00:00.000Z",
    "account_sid" : "AC0000000000000000000000000000001",
    "service_sid" : "VA0000000000000000000000000000001",
    "verification_sid" : "VE0000000000000000000000000000001",
    "attempt_sid" : "VL0000000000000000000000000000001",
    "error_code" : "",
    "channel" : "SMS",
    "message_status" : "DELIVERED",
    "has_fallback" : false,
    "is_fallback" : false,
    "mnc" : "460",
    "mcc" : "05",
    "to" : "+919999999999",
    "number_segments" : 2
  }
}
```

**Versions**

#### v1 (latest)

* `string` **created\_at** (required). The date when the attempt was created, given in ISO 8601 format.
* `string` **account\_sid** (required). Unique SID that identifies the Twilio account.
* `string` **service\_sid** (required). Unique SID that identifies the Verify service.
* `string` **verification\_sid** (required). Unique SID identifying the verification.
* `string` **attempt\_sid** (required). SID of the specific attempt used for delivering the verification.
* `string` **error\_code**. Error code returned in case the delivery failed; empty if successful.
* `string` **channel** (required). Channel used for verification such as SMS.
* `string` **message\_status** (required). Message status that the verification message returns, such as `DELIVERED` or `FAILED`.
* `boolean` **has\_fallback**. Flag that Indicates if a fallback channel was enabled.
* `boolean` **is\_fallback**. Flag that Indicates if the current verification is a fallback attempt.
* `string` **mnc**. Mobile Network Code that identifies the mobile carrier.
* `string` **mcc**. Mobile Country Code that identifies the country of the carrier.
* `string` **to** (required). Destination phone number expressed in E.164 format.
* `integer` **number\_segments**. Number of SMS segments used to deliver the verification message.

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

## Sent

`com.twilio.accountsecurity.verify.message.sent`

Message Status Sent 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.message.sent",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/AccountSecurity.MessageStatusEvent/1",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "created_at" : "2025-01-01T00:00:00.000Z",
    "account_sid" : "AC0000000000000000000000000000001",
    "service_sid" : "VA0000000000000000000000000000001",
    "verification_sid" : "VE0000000000000000000000000000001",
    "attempt_sid" : "VL0000000000000000000000000000001",
    "error_code" : "",
    "channel" : "SMS",
    "message_status" : "DELIVERED",
    "has_fallback" : false,
    "is_fallback" : false,
    "mnc" : "460",
    "mcc" : "05",
    "to" : "+919999999999",
    "number_segments" : 2
  }
}
```

**Versions**

#### v1 (latest)

* `string` **created\_at** (required). The date when the attempt was created, given in ISO 8601 format.
* `string` **account\_sid** (required). Unique SID that identifies the Twilio account.
* `string` **service\_sid** (required). Unique SID that identifies the Verify service.
* `string` **verification\_sid** (required). Unique SID identifying the verification.
* `string` **attempt\_sid** (required). SID of the specific attempt used for delivering the verification.
* `string` **error\_code**. Error code returned in case the delivery failed; empty if successful.
* `string` **channel** (required). Channel used for verification such as SMS.
* `string` **message\_status** (required). Message status that the verification message returns, such as `DELIVERED` or `FAILED`.
* `boolean` **has\_fallback**. Flag that Indicates if a fallback channel was enabled.
* `boolean` **is\_fallback**. Flag that Indicates if the current verification is a fallback attempt.
* `string` **mnc**. Mobile Network Code that identifies the mobile carrier.
* `string` **mcc**. Mobile Country Code that identifies the country of the carrier.
* `string` **to** (required). Destination phone number expressed in E.164 format.
* `integer` **number\_segments**. Number of SMS segments used to deliver the verification message.

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

## Undelivered

`com.twilio.accountsecurity.verify.message.undelivered`

Message Status Undelivered 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.message.undelivered",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/AccountSecurity.MessageStatusEvent/1",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "created_at" : "2025-01-01T00:00:00.000Z",
    "account_sid" : "AC0000000000000000000000000000001",
    "service_sid" : "VA0000000000000000000000000000001",
    "verification_sid" : "VE0000000000000000000000000000001",
    "attempt_sid" : "VL0000000000000000000000000000001",
    "error_code" : "",
    "channel" : "SMS",
    "message_status" : "DELIVERED",
    "has_fallback" : false,
    "is_fallback" : false,
    "mnc" : "460",
    "mcc" : "05",
    "to" : "+919999999999",
    "number_segments" : 2
  }
}
```

**Versions**

#### v1 (latest)

* `string` **created\_at** (required). The date when the attempt was created, given in ISO 8601 format.
* `string` **account\_sid** (required). Unique SID that identifies the Twilio account.
* `string` **service\_sid** (required). Unique SID that identifies the Verify service.
* `string` **verification\_sid** (required). Unique SID identifying the verification.
* `string` **attempt\_sid** (required). SID of the specific attempt used for delivering the verification.
* `string` **error\_code**. Error code returned in case the delivery failed; empty if successful.
* `string` **channel** (required). Channel used for verification such as SMS.
* `string` **message\_status** (required). Message status that the verification message returns, such as `DELIVERED` or `FAILED`.
* `boolean` **has\_fallback**. Flag that Indicates if a fallback channel was enabled.
* `boolean` **is\_fallback**. Flag that Indicates if the current verification is a fallback attempt.
* `string` **mnc**. Mobile Network Code that identifies the mobile carrier.
* `string` **mcc**. Mobile Country Code that identifies the country of the carrier.
* `string` **to** (required). Destination phone number expressed in E.164 format.
* `integer` **number\_segments**. Number of SMS segments used to deliver the verification message.

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