Sign in

v47

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-181,0851,7264.5 MB
Verification Requests

Get Verification Request

Get a single verification request by its ID.

get/messaging_tollfree/verification/requests/{id}

Path parameters

idstring uuid required

Unique identifier of the resource.

Response

Successful Response

businessNamestring required
corporateWebsitestring required
businessAddr1string required
businessAddr2string
businessCitystring required
businessStatestring required
businessZipstring required
businessContactFirstNamestring required
businessContactLastNamestring required
businessContactEmailstring required
businessContactPhonestring required
messageVolume'10' | '100' | '1,000' | '10,000' | '100,000' | '250,000' | '500,000' | '750,000' | '1,000,000' | '5,000,000' | '10,000,000+' required

Message Volume Enums

useCase'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' required

Tollfree usecase categories

useCaseSummarystring required
productionMessageContentstring required
optInWorkflowstring required
additionalInformationstring required
isvResellerstring
webhookUrlstring
businessRegistrationNumberstring
businessRegistrationTypestring
businessRegistrationCountrystring
doingBusinessAsstring
entityType'SOLE_PROPRIETOR' | 'PRIVATE_PROFIT' | 'PUBLIC_PROFIT' | 'NON_PROFIT' | 'GOVERNMENT'

Business entity classification

optInConfirmationResponsestring
helpMessageResponsestring
privacyPolicyURLstring
termsAndConditionURLstring
ageGatedContentboolean
optInKeywordsstring
campaignVerifyAuthorizationTokenstring nullable

Campaign Verify Authorization Token required for Political use case submissions starting February 17, 2026

idstring uuid required
verificationStatus'Verified' | 'Rejected' | 'Waiting For Vendor' | 'Waiting For Customer' | 'Waiting For Telnyx' | 'In Progress' required

Tollfree verification status

reasonstring
createdAtstring date-time
updatedAtstring date-time

Example response

{
  "businessName": "Telnyx LLC",
  "corporateWebsite": "http://example.com",
  "businessAddr1": "600 Congress Avenue",
  "businessAddr2": "14th Floor",
  "businessCity": "Austin",
  "businessState": "Texas",
  "businessZip": "78701",
  "businessContactFirstName": "John",
  "businessContactLastName": "Doe",
  "businessContactEmail": "email@example.com",
  "businessContactPhone": "+18889809750",
  "phoneNumbers": [
    {
      "phoneNumber": "+18773554398"
    },
    {
      "phoneNumber": "+18773554399"
    }
  ],
  "useCaseSummary": "This is a use case where Telnyx sends out 2FA codes to portal users to verify their identity in order to sign into the portal",
  "productionMessageContent": "Your Telnyx OTP is XXXX",
  "optInWorkflow": "User signs into the Telnyx portal, enters number and is prompted to select whether they want to use 2FA verification for security purposes. If they've opted in a confirmation message is sent out to the handset",
  "optInWorkflowImageURLs": [
    {
      "url": "https://telnyx.com/sign-up"
    },
    {
      "url": "https://telnyx.com/company/data-privacy"
    }
  ],
  "additionalInformation": "This is for security purposes, blah blah blah",
  "isvReseller": "Yes",
  "webhookUrl": "http://example-webhook.com",
  "businessRegistrationNumber": "12-3456789",
  "businessRegistrationType": "EIN",
  "businessRegistrationCountry": "US",
  "doingBusinessAs": "Acme Services",
  "optInConfirmationResponse": "You have successfully opted in to receive messages from Acme Corp",
  "helpMessageResponse": "Reply HELP for assistance or STOP to unsubscribe. Contact: support@example.com",
  "privacyPolicyURL": "https://example.com/privacy",
  "termsAndConditionURL": "https://example.com/terms",
  "optInKeywords": "START, YES, SUBSCRIBE",
  "campaignVerifyAuthorizationToken": "cv_token_abc123xyz",
  "id": "eaba9f52-164e-58e0-b002-4f668e18b7ed",
  "reason": "Unfortunately, we have to cancel this request as we do not support non tollfree US numbers.",
  "createdAt": "2024-01-23T18:10:02.574Z",
  "updatedAt": "2024-01-23T18:10:02.574Z"
}