---
"@context": https://schema.org
"@type": TechArticle
"@id": https://www.twilio.com/docs/events/event-types/toll-free/verification#article
headline: Verification
description: List of Toll Free event types regarding Verification available in Twilio Event Streams, as well as their JSON schemas and examples.
url: https://www.twilio.com/docs/events/event-types/toll-free/verification
inLanguage: en
dateModified: 2026-10-12T19:18:47.000Z
author:
  "@type": Organization
  name: Twilio Developer Education Team
publisher:
  "@type": Organization
  name: Twilio
---

# Verification

## Edited

`com.twilio.messaging.compliance.toll-free-verification.edit`

Verification Edited 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/messaging/compliance/toll-free/api-onboarding).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.messaging.compliance.toll-free-verification.edit",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/TollFree.VerificationEdit/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "accountsid" : "AC0000000000000000000000000000001",
    "parentaccountsid" : "AC0000000000000000000000000000002",
    "tollfreeverificationsid" : "HH0000000000000000000000000000001",
    "phonenumbersid" : "PN0000000000000000000000000000001",
    "customerprofilesid" : "BU0000000000000000000000000000001",
    "regulateditemsid" : "RA0000000000000000000000000000001",
    "trustproductsid" : "BU0000000000000000000000000000001",
    "processeddate" : 1756043494500,
    "verificationstatus" : "in_review"
  }
}
```

**Versions**

* [v2 (latest)](https://events-schemas.twilio.com/TollFree.VerificationEdit/2)
* [v1](https://events-schemas.twilio.com/TollFree.VerificationEdit/1)

## Expired

`com.twilio.messaging.compliance.toll-free-verification.expired`

Verification 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/messaging/compliance/toll-free/api-onboarding).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.messaging.compliance.toll-free-verification.expired",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/TollFree.VerificationExpired/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "accountsid" : "AC0000000000000000000000000000001",
    "parentaccountsid" : "AC0000000000000000000000000000002",
    "tollfreeverificationsid" : "HH0000000000000000000000000000001",
    "phonenumbersid" : "PN0000000000000000000000000000001",
    "customerprofilesid" : "BU0000000000000000000000000000001",
    "regulateditemsid" : "RA0000000000000000000000000000001",
    "trustproductsid" : "BU0000000000000000000000000000001",
    "processeddate" : 1756043494500,
    "verificationstatus" : "expired",
    "errorcode" : 30437,
    "errordescription" : "Rejection Edit Time Window Expired"
  }
}
```

**Versions**

* [v2 (latest)](https://events-schemas.twilio.com/TollFree.VerificationExpired/2)
* [v1](https://events-schemas.twilio.com/TollFree.VerificationExpired/1)

## Failed

`com.twilio.messaging.compliance.toll-free-verification.failure`

Verification 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/messaging/compliance/toll-free/api-onboarding).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.messaging.compliance.toll-free-verification.failure",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/TollFree.VerificationFailure/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "accountsid" : "AC0000000000000000000000000000001",
    "parentaccountsid" : "AC0000000000000000000000000000002",
    "tollfreeverificationsid" : "HH0000000000000000000000000000001",
    "phonenumbersid" : "PN0000000000000000000000000000001",
    "customerprofilesid" : "BU0000000000000000000000000000001",
    "regulateditemsid" : "RA0000000000000000000000000000001",
    "trustproductsid" : "BU0000000000000000000000000000001",
    "processeddate" : 1756043494500,
    "verificationstatus" : "twilio_rejected",
    "failuredescription" : "Failed to edit verification",
    "failurereason" : "edit failed",
    "failedoperation" : "edit"
  }
}
```

**Versions**

* [v2 (latest)](https://events-schemas.twilio.com/TollFree.VerificationFailure/2)
* [v1](https://events-schemas.twilio.com/TollFree.VerificationFailure/1)

## Requested

`com.twilio.messaging.compliance.toll-free-verification.requested`

Verification Requested 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/messaging/compliance/toll-free/api-onboarding).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.messaging.compliance.toll-free-verification.requested",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/TollFree.VerificationRequested/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "accountsid" : "AC0000000000000000000000000000001",
    "parentaccountsid" : "AC0000000000000000000000000000002",
    "tollfreeverificationsid" : "HH0000000000000000000000000000001",
    "phonenumbersid" : "PN0000000000000000000000000000001",
    "customerprofilesid" : "BU0000000000000000000000000000001",
    "regulateditemsid" : "RA0000000000000000000000000000001",
    "trustproductsid" : "BU0000000000000000000000000000001",
    "processeddate" : 1756043494500,
    "verificationstatus" : "in_review"
  }
}
```

**Versions**

* [v2 (latest)](https://events-schemas.twilio.com/TollFree.VerificationRequested/2)
* [v1](https://events-schemas.twilio.com/TollFree.VerificationRequested/1)

## Review Pending

`com.twilio.messaging.compliance.toll-free-verification.pending-review`

Verification Review 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/messaging/compliance/toll-free/api-onboarding).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.messaging.compliance.toll-free-verification.pending-review",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/TollFree.VerificationPendingReview/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "accountsid" : "AC0000000000000000000000000000001",
    "parentaccountsid" : "AC0000000000000000000000000000002",
    "tollfreeverificationsid" : "HH0000000000000000000000000000001",
    "phonenumbersid" : "PN0000000000000000000000000000001",
    "customerprofilesid" : "BU0000000000000000000000000000001",
    "regulateditemsid" : "RA0000000000000000000000000000001",
    "trustproductsid" : "BU0000000000000000000000000000001",
    "processeddate" : 1756043494500,
    "verificationstatus" : "pending_review"
  }
}
```

**Versions**

* [v2 (latest)](https://events-schemas.twilio.com/TollFree.VerificationPendingReview/2)
* [v1](https://events-schemas.twilio.com/TollFree.VerificationPendingReview/1)

## Twilio Approved

`com.twilio.messaging.compliance.toll-free-verification.request-approved`

Verification Twilio 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/messaging/compliance/toll-free/api-onboarding).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.messaging.compliance.toll-free-verification.request-approved",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/TollFree.VerificationRequestApproved/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "accountsid" : "AC0000000000000000000000000000001",
    "parentaccountsid" : "AC0000000000000000000000000000002",
    "tollfreeverificationsid" : "HH0000000000000000000000000000001",
    "phonenumbersid" : "PN0000000000000000000000000000001",
    "customerprofilesid" : "BU0000000000000000000000000000001",
    "regulateditemsid" : "RA0000000000000000000000000000001",
    "trustproductsid" : "BU0000000000000000000000000000001",
    "processeddate" : 1756043494500,
    "verificationstatus" : "twilio_approved"
  }
}
```

**Versions**

* [v2 (latest)](https://events-schemas.twilio.com/TollFree.VerificationRequestApproved/2)
* [v1](https://events-schemas.twilio.com/TollFree.VerificationRequestApproved/1)

## Twilio Deleted

`com.twilio.messaging.compliance.toll-free-verification.deleted`

Verification Twilio Deleted 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/messaging/compliance/toll-free/api-onboarding).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.messaging.compliance.toll-free-verification.deleted",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/TollFree.VerificationDeleted/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "accountsid" : "AC0000000000000000000000000000001",
    "parentaccountsid" : "AC0000000000000000000000000000002",
    "tollfreeverificationsid" : "HH0000000000000000000000000000001",
    "phonenumbersid" : "PN0000000000000000000000000000001",
    "customerprofilesid" : "BU0000000000000000000000000000001",
    "regulateditemsid" : "RA0000000000000000000000000000001",
    "trustproductsid" : "BU0000000000000000000000000000001",
    "processeddate" : 1756043494500
  }
}
```

**Versions**

* [v2 (latest)](https://events-schemas.twilio.com/TollFree.VerificationDeleted/2)
* [v1](https://events-schemas.twilio.com/TollFree.VerificationDeleted/1)

## Twilio Rejected

`com.twilio.messaging.compliance.toll-free-verification.request-rejected`

Verification Twilio Rejected 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/messaging/compliance/toll-free/api-onboarding).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.messaging.compliance.toll-free-verification.request-rejected",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/TollFree.VerificationRequestRejected/5",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "accountsid" : "AC0000000000000000000000000000001",
    "parentaccountsid" : "AC0000000000000000000000000000002",
    "tollfreeverificationsid" : "HH0000000000000000000000000000001",
    "phonenumber" : "+11234567890",
    "phonenumbersid" : "PN0000000000000000000000000000001",
    "customerprofilesid" : "BU0000000000000000000000000000001",
    "regulateditemsid" : "RA0000000000000000000000000000001",
    "trustproductsid" : "BU0000000000000000000000000000001",
    "processeddate" : 1756043494500,
    "verificationstatus" : "twilio_rejected",
    "errorcode" : 30482,
    "errorcodes" : "30482,30484",
    "errordescription" : "Business email must use an official domain; Business name doesn't match official records",
    "rejectiondate" : 1756043499500,
    "editexpiration" : 1756043594500,
    "editallowed" : true
  }
}
```

**Versions**

* [v5 (latest)](https://events-schemas.twilio.com/TollFree.VerificationRequestRejected/5)
* [v4](https://events-schemas.twilio.com/TollFree.VerificationRequestRejected/4)
* [v3](https://events-schemas.twilio.com/TollFree.VerificationRequestRejected/3)
* [v2](https://events-schemas.twilio.com/TollFree.VerificationRequestRejected/2)
* [v1](https://events-schemas.twilio.com/TollFree.VerificationRequestRejected/1)