> ## Documentation Index
> Fetch the complete documentation index at: https://plivo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Toll-free Verification Object

> Toll-free verification object attributes and response fields

The Toll-free Verification Object contains the following fields.

<table>
  <tbody>
    <tr>
      <td>**uuid**<br />**string**</td>
      <td>The unique identifier for the verification request.</td>
    </tr>

    <tr>
      <td>**profile\_uuid**<br />**string**</td>
      <td>The unique identifier of an existing Plivo profile.</td>
    </tr>

    <tr>
      <td>**number**<br />**string**</td>
      <td>The toll-free number for which verification is being initiated.</td>
    </tr>

    <tr>
      <td>**usecase**<br />**list**</td>

      <td>
        The messaging use case(s) for which the toll-free number will be used. This should be set as one or more of the following options:<br />

        * 2FA
        * ACCOUNT\_NOTIFICATION
        * CUSTOMER\_CARE
        * DELIVERY\_NOTIFICATION
        * FRAUD\_ALERT
        * HIGHER\_EDUCATION
        * MARKETING
        * POLLING\_VOTING
        * PUBLIC\_SERVICE\_ANNOUNCEMENT
        * SECURITY\_ALERT

        <br />

        One use case is mandatory. Multiple use cases can be added as a list of strings.
      </td>
    </tr>

    <tr>
      <td>**usecase\_summary**<br />**string**</td>
      <td>The explanation of how messaging will be used on the toll-free phone number(s) by your business.</td>
    </tr>

    <tr>
      <td>**message\_sample**<br />**string**</td>
      <td>Sample message(s) that your business will send to the end-user/mobile device. Multiple sample messages are allowed.</td>
    </tr>

    <tr>
      <td>**optin\_image\_url**<br />**list**</td>

      <td>
        A valid URL where you submit images explaining details of the opt-in process for the end user. Multiple URLs are allowed as a list of strings.

        <br />

        **Note:** This URL should align with the details added to the optin\_type.
      </td>
    </tr>

    <tr>
      <td>**optin\_type**<br />**string**</td>

      <td>
        Describes how a user opts into receiving text messages. One of the following exact values should be provided:<br />

        * VERBAL
        * WEB\_FORM
        * PAPER\_FORM
        * VIA\_TEXT
        * MOBILE\_QR\_CODE

        <br />

        **-VERBAL** must include the sample verbal consent collection and examples in a document linked in the optin\_image\_url parameter.

        **-WEB\_FORM** must include the link to the form in the optin\_image\_url parameter.

        **-PAPER\_FORM** must include a link to the form in the optin\_image\_url parameter. It can be a scanned image.

        **-VIA\_TEXT** must describe the keyword campaign in a document linked in the optin\_image\_url parameter.

        **-MOBILE\_QR\_CODE** must include the QR code in a document linked in the optin\_image\_url parameter.

        The sample submitted in the opt-in\_image\_url parameter should match the opt-in type selection.
      </td>
    </tr>

    <tr>
      <td>**volume**<br />**string**</td>

      <td>
        An estimate of the monthly volume of messages you will send from the toll-free number. One of the following exact values should be provided:<br />

        * 1,000
        * 10,000
        * 100,000
        * 250,000
        * 500,000
        * 750,000
        * 1,000,000
        * 5,000,000
        * 10,000,000+

        <br />

        If your monthly volumes are expected to increase, it is advisable to provide a value that accommodates the projected growth and remains suitable for the next six to eight months.
      </td>
    </tr>

    <tr>
      <td>**additional\_information** <br />**string**</td>
      <td>Any additional information related to the website, such as a link to the terms of service (TOS) page or privacy policy, that can help clarify the verification request.</td>
    </tr>

    <tr>
      <td>**extra\_data**<br />**string**</td>
      <td>Any additional information that you would like to include for your own internal reference.</td>
    </tr>

    <tr>
      <td>**status**<br />**string**</td>
      <td>The status of the toll-free verification request.</td>
    </tr>

    <tr>
      <td>**rejection\_reason**<br />**string**</td>
      <td>The reason for toll-free verification rejection.</td>
    </tr>

    <tr>
      <td>**callback\_url**<br />**string**</td>
      <td>A valid URL where verification-related callbacks will be sent.</td>
    </tr>

    <tr>
      <td>**created**<br />**datetime**</td>
      <td>The date when the verification request was created.</td>
    </tr>

    <tr>
      <td>**last\_modified**<br />**datetime**</td>
      <td>The date when the verification request was last modified.</td>
    </tr>
  </tbody>
</table>