---
title: "Get Verification Request"
method: GET
path: "/messaging_tollfree/verification/requests/{id}"
tags: ["Verification Requests"]
---

# Get Verification Request

`GET /messaging_tollfree/verification/requests/{id}`

Get a single verification request by its ID.

## Path parameters

- `id` string, uuid, required

## Response `200`

Successful Response

- MessagingTollFreeVerificationVerificationRequestStatus — A verification request and its status, suitable for returning to users
  - `businessName` string, required
  - `corporateWebsite` string, required
  - `businessAddr1` string, required
  - `businessAddr2` string
  - `businessCity` string, required
  - `businessState` string, required
  - `businessZip` string, required
  - `businessContactFirstName` string, required
  - `businessContactLastName` string, required
  - `businessContactEmail` string, required
  - `businessContactPhone` string, 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
  - `phoneNumbers` TFPhoneNumber[], required
    - `phoneNumber` string, required
  - `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
  - `useCaseSummary` string, required
  - `productionMessageContent` string, required
  - `optInWorkflow` string, required
  - `optInWorkflowImageURLs` Url[], required
    - `url` string, uri, required
  - `additionalInformation` string, required
  - `isvReseller` string
  - `webhookUrl` string
  - `businessRegistrationNumber` string
  - `businessRegistrationType` string
  - `businessRegistrationCountry` string
  - `doingBusinessAs` string
  - `entityType` 'SOLE_PROPRIETOR' | 'PRIVATE_PROFIT' | 'PUBLIC_PROFIT' | 'NON_PROFIT' | 'GOVERNMENT' — Business entity classification
  - `optInConfirmationResponse` string
  - `helpMessageResponse` string
  - `privacyPolicyURL` string
  - `termsAndConditionURL` string
  - `ageGatedContent` boolean
  - `optInKeywords` string
  - `campaignVerifyAuthorizationToken` string, nullable — Campaign Verify Authorization Token required for Political use case submissions starting February 17, 2026
  - `id` string, uuid, required
  - `verificationStatus` 'Verified' | 'Rejected' | 'Waiting For Vendor' | 'Waiting For Customer' | 'Waiting For Telnyx' | 'In Progress', required — Tollfree verification status
  - `reason` string
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

## Other responses

- `4XX` — Generic error response

## Changes

> 72 revisions in range; 1 not diffed.

- **2026-09-16** `a6a61a29ecdd` — 1 breaking, 2 info
  - the `errors/items/code` response's property type changed from `string` to `integer`, and format from no format to `int32` for status `4XX`
  - added `#/components/schemas/messaging_toll_free_verification_EntityType` to the `entityType` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/toll-free-verification_EntityType` from the `entityType` response property `allOf` list for the response status `200`
- **2026-08-17** `1571b0380bd7` — 1 breaking, 2 info
  - the `errors/items/code` response's property type changed from `integer` to `string`, and format from `int32` to no format for status `4XX`
  - added `#/components/schemas/toll-free-verification_EntityType` to the `entityType` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/messaging_toll_free_verification_EntityType` from the `entityType` response property `allOf` list for the response status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/messaging_tollfree/verification/requests/:id/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/e0de72cf4744?raw)