Telnyx · Schema

VerificationRequest

The body of a tollfree verification request

CommunicationsCPaaSVoiceSMSIoTTelecommunicationsMessagingArtificial IntelligenceMCPVoice AIPhone NumbersInferenceNumber VerificationPhone VerificationOTP2FALookupVerifyNumber LookupCNAMIdentityFraud Prevention

Properties

Name	Type	Description
additionalInformation	string	Any additional information
ageGatedContent	boolean	Indicates if messaging content requires age gating (e.g., 18+). Defaults to false if not provided.
businessAddr1	string	Line 1 of the business address
businessAddr2	string	Line 2 of the business address
businessCity	string	The city of the business address; the first letter should be capitalized
businessContactEmail	string	The email address of the business contact
businessContactFirstName	string	First name of the business contact; there are no specific requirements on formatting
businessContactLastName	string	Last name of the business contact; there are no specific requirements on formatting
businessContactPhone	string	The phone number of the business contact in E.164 format
businessName	string	Name of the business; there are no specific formatting requirements
businessRegistrationCountry	stringnull	ISO 3166-1 alpha-2 country code of the issuing business authority. Must be exactly 2 letters. Automatically converted to uppercase. Required from January 2026.
businessRegistrationNumber	stringnull	Official business registration number (e.g., Employer Identification Number (EIN) in the U.S.). Required from January 2026.
businessRegistrationType	stringnull	Type of business registration being provided. Required from January 2026.
businessState	string	The full name of the state (not the 2 letter code) of the business address; the first letter should be capitalized
businessZip	string	The ZIP code of the business address
campaignVerifyAuthorizationToken	stringnull	Campaign Verify Authorization Token required for Political use case submissions starting February 17, 2026. This token is validated by Zipwhip and must be provided for all Political use case verificat
corporateWebsite	string	A URL, including the scheme, pointing to the corporate website
doingBusinessAs	stringnull	Doing Business As (DBA) name if different from legal name
entityType	object	Business entity classification. Must be one of the 5 valid enum values.
helpMessageResponse	stringnull	The message returned when users text 'HELP'
isvReseller	stringnull	ISV name
messageVolume	object	Estimated monthly volume of messages from the given phone numbers
optInConfirmationResponse	stringnull	Message sent to users confirming their opt-in to receive messages
optInKeywords	stringnull	Keywords used to collect and process consumer opt-ins
optInWorkflow	string	Human-readable description of how end users will opt into receiving messages from the given phone numbers
optInWorkflowImageURLs	array	Images showing the opt-in workflow
phoneNumbers	array	The phone numbers to request the verification of
privacyPolicyURL	stringnull	URL pointing to the business's privacy policy. Plain string, no URL format validation.
productionMessageContent	string	An example of a message that will be sent from the given phone numbers
termsAndConditionURL	stringnull	URL pointing to the business's terms and conditions. Plain string, no URL format validation.
useCase	object	Machine-readable use-case for the phone numbers
useCaseSummary	string	Human-readable summary of the desired use-case
webhookUrl	string	URL that should receive webhooks relating to this verification request

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/telnyx/json-schema/telnyx-tfverification-request-schema.json",
  "title": "VerificationRequest",
  "description": "The body of a tollfree verification request",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/telnyx-verification-requests-api-openapi.yml#/components/schemas/TFVerificationRequest",
  "properties": {
    "additionalInformation": {
      "description": "Any additional information",
      "maxLength": 500,
      "title": "Additionalinformation",
      "type": "string"
    },
    "ageGatedContent": {
      "default": false,
      "description": "Indicates if messaging content requires age gating (e.g., 18+). Defaults to false if not provided.",
      "title": "Agegatedcontent",
      "type": "boolean"
    },
    "businessAddr1": {
      "description": "Line 1 of the business address",
      "maxLength": 500,
      "title": "Businessaddr1",
      "type": "string"
    },
    "businessAddr2": {
      "description": "Line 2 of the business address",
      "maxLength": 500,
      "title": "Businessaddr2",
      "type": "string"
    },
    "businessCity": {
      "description": "The city of the business address; the first letter should be capitalized",
      "maxLength": 500,
      "title": "Businesscity",
      "type": "string"
    },
    "businessContactEmail": {
      "description": "The email address of the business contact",
      "maxLength": 500,
      "title": "Businesscontactemail",
      "type": "string"
    },
    "businessContactFirstName": {
      "description": "First name of the business contact; there are no specific requirements on formatting",
      "maxLength": 500,
      "title": "Businesscontactfirstname",
      "type": "string"
    },
    "businessContactLastName": {
      "description": "Last name of the business contact; there are no specific requirements on formatting",
      "maxLength": 500,
      "title": "Businesscontactlastname",
      "type": "string"
    },
    "businessContactPhone": {
      "description": "The phone number of the business contact in E.164 format",
      "maxLength": 500,
      "title": "Businesscontactphone",
      "type": "string"
    },
    "businessName": {
      "description": "Name of the business; there are no specific formatting requirements",
      "maxLength": 500,
      "title": "Businessname",
      "type": "string"
    },
    "businessRegistrationCountry": {
      "description": "ISO 3166-1 alpha-2 country code of the issuing business authority. Must be exactly 2 letters. Automatically converted to uppercase. Required from January 2026.",
      "maxLength": 2,
      "pattern": "^[A-Z]{2}$",
      "title": "Businessregistrationcountry",
      "type": [
        "string",
        "null"
      ]
    },
    "businessRegistrationNumber": {
      "description": "Official business registration number (e.g., Employer Identification Number (EIN) in the U.S.). Required from January 2026.",
      "maxLength": 500,
      "title": "Businessregistrationnumber",
      "type": [
        "string",
        "null"
      ]
    },
    "businessRegistrationType": {
      "description": "Type of business registration being provided. Required from January 2026.",
      "maxLength": 500,
      "title": "Businessregistrationtype",
      "type": [
        "string",
        "null"
      ]
    },
    "businessState": {
      "description": "The full name of the state (not the 2 letter code) of the business address; the first letter should be capitalized",
      "maxLength": 500,
      "title": "Businessstate",
      "type": "string"
    },
    "businessZip": {
      "description": "The ZIP code of the business address",
      "maxLength": 500,
      "title": "Businesszip",
      "type": "string"
    },
    "campaignVerifyAuthorizationToken": {
      "description": "Campaign Verify Authorization Token required for Political use case submissions starting February 17, 2026. This token is validated by Zipwhip and must be provided for all Political use case verifications after the deadline.",
      "maxLength": 500,
      "title": "Campaignverifyauthorizationtoken",
      "type": [
        "string",
        "null"
      ]
    },
    "corporateWebsite": {
      "description": "A URL, including the scheme, pointing to the corporate website",
      "maxLength": 500,
      "title": "Corporatewebsite",
      "type": "string"
    },
    "doingBusinessAs": {
      "description": "Doing Business As (DBA) name if different from legal name",
      "maxLength": 500,
      "title": "Doingbusinessas",
      "type": [
        "string",
        "null"
      ]
    },
    "entityType": {
      "anyOf": [
        {
          "$ref": "#/$defs/toll-free-verification_EntityType"
        },
        {
          "type": "null"
        }
      ],
      "description": "Business entity classification. Must be one of the 5 valid enum values."
    },
    "helpMessageResponse": {
      "description": "The message returned when users text 'HELP'",
      "maxLength": 500,
      "title": "Helpmessageresponse",
      "type": [
        "string",
        "null"
      ]
    },
    "isvReseller": {
      "description": "ISV name",
      "maxLength": 500,
      "title": "Isvreseller",
      "type": [
        "string",
        "null"
      ]
    },
    "messageVolume": {
      "allOf": [
        {
          "$ref": "#/$defs/Volume"
        }
      ],
      "description": "Estimated monthly volume of messages from the given phone numbers"
    },
    "optInConfirmationResponse": {
      "description": "Message sent to users confirming their opt-in to receive messages",
      "maxLength": 500,
      "title": "Optinconfirmationresponse",
      "type": [
        "string",
        "null"
      ]
    },
    "optInKeywords": {
      "description": "Keywords used to collect and process consumer opt-ins",
      "maxLength": 500,
      "title": "Optinkeywords",
      "type": [
        "string",
        "null"
      ]
    },
    "optInWorkflow": {
      "description": "Human-readable description of how end users will opt into receiving messages from the given phone numbers",
      "maxLength": 500,
      "title": "Optinworkflow",
      "type": "string"
    },
    "optInWorkflowImageURLs": {
      "description": "Images showing the opt-in workflow",
      "items": {
        "$ref": "#/$defs/Url"
      },
      "minItems": 1,
      "title": "Optinworkflowimageurls",
      "type": "array"
    },
    "phoneNumbers": {
      "description": "The phone numbers to request the verification of",
      "items": {
        "$ref": "#/$defs/TFPhoneNumber"
      },
      "minItems": 1,
      "title": "Phonenumbers",
      "type": "array"
    },
    "privacyPolicyURL": {
      "description": "URL pointing to the business's privacy policy. Plain string, no URL format validation.",
      "maxLength": 500,
      "title": "Privacypolicyurl",
      "type": [
        "string",
        "null"
      ]
    },
    "productionMessageContent": {
      "description": "An example of a message that will be sent from the given phone numbers",
      "maxLength": 1000,
      "title": "Productionmessagecontent",
      "type": "string"
    },
    "termsAndConditionURL": {
      "description": "URL pointing to the business's terms and conditions. Plain string, no URL format validation.",
      "maxLength": 500,
      "title": "Termsandconditionurl",
      "type": [
        "string",
        "null"
      ]
    },
    "useCase": {
      "allOf": [
        {
          "$ref": "#/$defs/UseCaseCategories"
        }
      ],
      "description": "Machine-readable use-case for the phone numbers"
    },
    "useCaseSummary": {
      "description": "Human-readable summary of the desired use-case",
      "maxLength": 500,
      "title": "Usecasesummary",
      "type": "string"
    },
    "webhookUrl": {
      "description": "URL that should receive webhooks relating to this verification request",
      "maxLength": 500,
      "title": "Webhookurl",
      "type": "string"
    }
  },
  "required": [
    "businessName",
    "corporateWebsite",
    "businessAddr1",
    "businessCity",
    "businessState",
    "businessZip",
    "businessContactFirstName",
    "businessContactLastName",
    "businessContactEmail",
    "businessContactPhone",
    "messageVolume",
    "phoneNumbers",
    "useCase",
    "useCaseSummary",
    "productionMessageContent",
    "optInWorkflow",
    "optInWorkflowImageURLs",
    "additionalInformation"
  ],
  "type": "object",
  "$defs": {
    "TFPhoneNumber": {
      "description": "A phone number",
      "properties": {
        "phoneNumber": {
          "title": "Phonenumber",
          "type": "string"
        }
      },
      "required": [
        "phoneNumber"
      ],
      "title": "PhoneNumber",
      "type": "object"
    },
    "Url": {
      "properties": {
        "url": {
          "format": "uri",
          "maxLength": 2083,
          "minLength": 1,
          "title": "Url",
          "type": "string"
        }
      },
      "required": [
        "url"
      ],
      "title": "Url",
      "type": "object"
    },
    "UseCaseCategories": {
      "description": "Tollfree usecase categories",
      "enum": [
        "2FA",
        "App Notifications",
        "Appointments",
        "Auctions",
        "Auto Repair Services",
        "Bank Transfers",
        "Billing",
        "Booking Confirmations",
        "Business Updates",
        "COVID-19 Alerts",
        "Career Training",
        "Chatbot",
        "Conversational / Alerts",
        "Courier Services & Deliveries",
        "Emergency Alerts",
        "Events & Planning",
        "Financial Services",
        "Fraud Alerts",
        "Fundraising",
        "General Marketing",
        "General School Updates",
        "HR / Staffing",
        "Healthcare Alerts",
        "Housing Community Updates",
        "Insurance Services",
        "Job Dispatch",
        "Legal Services",
        "Mixed",
        "Motivational Reminders",
        "Notary Notifications",
        "Order Notifications",
        "Political",
        "Public Works",
        "Real Estate Services",
        "Religious Services",
        "Repair and Diagnostics Alerts",
        "Rewards Program",
        "Surveys",
        "System Alerts",
        "Voting Reminders",
        "Waitlist Alerts",
        "Webinar Reminders",
        "Workshop Alerts"
      ],
      "title": "UseCaseCategories",
      "type": "string"
    },
    "Volume": {
      "description": "Message Volume Enums",
      "enum": [
        "10",
        "100",
        "1,000",
        "10,000",
        "100,000",
        "250,000",
        "500,000",
        "750,000",
        "1,000,000",
        "5,000,000",
        "10,000,000+"
      ],
      "title": "Volume",
      "type": "string"
    },
    "toll-free-verification_EntityType": {
      "description": "Business entity classification",
      "enum": [
        "SOLE_PROPRIETOR",
        "PRIVATE_PROFIT",
        "PUBLIC_PROFIT",
        "NON_PROFIT",
        "GOVERNMENT"
      ],
      "title": "EntityType",
      "type": "string"
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this

find_json_schemasBrowse and filter every JSON Schema in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This JSON Schema

curl "https://apis.io/api/v1/json-schemas/telnyx-tfverification-request"

All schemas

curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.