{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/twilio/main/json-schema/twilio-create-compliance-tollfree-inquiry-request-schema.json",
  "title": "CreateComplianceTollfreeInquiryRequest",
  "x-generated": "2026-10-08",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/twilio-complianceinquiries-api-openapi.yml#/components/schemas/CreateComplianceTollfreeInquiryRequest",
  "type": "object",
  "required": [
    "TollfreePhoneNumber",
    "NotificationEmail"
  ],
  "properties": {
    "TollfreePhoneNumber": {
      "type": "string",
      "format": "phone-number",
      "description": "The Tollfree phone number to be verified"
    },
    "NotificationEmail": {
      "type": "string",
      "description": "The email address to receive the notification about the verification result."
    },
    "BusinessName": {
      "type": "string",
      "description": "The name of the business or organization using the Tollfree number."
    },
    "BusinessWebsite": {
      "type": "string",
      "description": "The website of the business or organization using the Tollfree number."
    },
    "UseCaseCategories": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The category of the use case for the Tollfree Number. List as many are applicable.."
    },
    "UseCaseSummary": {
      "type": "string",
      "description": "Use this to further explain how messaging is used by the business or organization."
    },
    "ProductionMessageSample": {
      "type": "string",
      "description": "An example of message content, i.e. a sample message."
    },
    "OptInImageUrls": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Link to an image that shows the opt-in workflow. Multiple images allowed and must be a publicly hosted URL."
    },
    "OptInType": {
      "type": "string",
      "$ref": "#/$defs/compliance_tollfree_inquiry_enum_opt_in_type",
      "description": "Describe how a user opts-in to text messages."
    },
    "MessageVolume": {
      "type": "string",
      "description": "Estimate monthly volume of messages from the Tollfree Number."
    },
    "BusinessStreetAddress": {
      "type": "string",
      "description": "The address of the business or organization using the Tollfree number."
    },
    "BusinessStreetAddress2": {
      "type": "string",
      "description": "The address of the business or organization using the Tollfree number."
    },
    "BusinessCity": {
      "type": "string",
      "description": "The city of the business or organization using the Tollfree number."
    },
    "BusinessStateProvinceRegion": {
      "type": "string",
      "description": "The state/province/region of the business or organization using the Tollfree number."
    },
    "BusinessPostalCode": {
      "type": "string",
      "description": "The postal code of the business or organization using the Tollfree number."
    },
    "BusinessCountry": {
      "type": "string",
      "description": "The country of the business or organization using the Tollfree number."
    },
    "AdditionalInformation": {
      "type": "string",
      "description": "Additional information to be provided for verification."
    },
    "BusinessContactFirstName": {
      "type": "string",
      "description": "The first name of the contact for the business or organization using the Tollfree number."
    },
    "BusinessContactLastName": {
      "type": "string",
      "description": "The last name of the contact for the business or organization using the Tollfree number."
    },
    "BusinessContactEmail": {
      "type": "string",
      "description": "The email address of the contact for the business or organization using the Tollfree number."
    },
    "BusinessContactPhone": {
      "type": "string",
      "format": "phone-number",
      "description": "The phone number of the contact for the business or organization using the Tollfree number."
    }
  },
  "$defs": {
    "compliance_tollfree_inquiry_enum_opt_in_type": {
      "type": "string",
      "enum": [
        "VERBAL",
        "WEB_FORM",
        "PAPER_FORM",
        "VIA_TEXT",
        "MOBILE_QR_CODE"
      ]
    }
  }
}