---
title: "List Verification Requests"
method: GET
path: "/messaging_tollfree/verification/requests"
tags: ["Verification Requests"]
---

# List Verification Requests

`GET /messaging_tollfree/verification/requests`

Get a list of previously-submitted tollfree verification requests

## Query parameters

- `page` integer, required
- `page_size` integer, required — Request this many records per page This value is automatically clamped if the provided value is too large.
- `date_start` string, date-time
- `date_end` string, date-time
- `status` 'Verified' | 'Rejected' | 'Waiting For Vendor' | 'Waiting For Customer' | 'Waiting For Telnyx' | 'In Progress' — Tollfree verification status
- `phone_number` string
- `business_name` string

## Response `200`

Successful Response

- PaginatedVerificationRequestStatus — A paginated response
  - `records` VerificationRequestStatus[], required — The records yielded by this request
    - `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
  - `total_records` integer, required — The total amount of records for these query parameters

## Other responses

- `4XX` — Generic error response

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/8f5f4e537994/schema)