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

# Get Verification Request Status History

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

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/messaging_tollfree/verification/requests/{id}/status_history`
- Auth: HTTP bearer

Get the history of status changes for a verification request.

Returns a paginated list of historical status changes including the reason for each change and when it occurred.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `page[number]` integer, required
- `page[size]` integer, required: Request this many records per page. This value is automatically clamped if the provided value is too large.

## Response `200`

Successful Response

- PaginatedVerificationStatusHistoryEntry: A paginated response
  - `records` VerificationStatusHistoryEntry[], required: The records yielded by this request
    - `verificationStatus` 'Verified' | 'Rejected' | 'Waiting For Vendor' | 'Waiting For Customer' | 'Waiting For Telnyx' | 'In Progress', required: Tollfree verification status
    - `reason` string, nullable: An explanation of why this request has its current status.
    - `updatedAt` string, date-time, required: The timestamp at which this status change occurred
  - `total_records` integer, required: The total amount of records for these query parameters

## Other responses

- `4XX`: Generic error response

## Changes

> 152 revisions in range; 1 not diffed.

- **2026-10-21** `19db5ee4ec59`: 1 breaking, 1 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 the optional property `errors/items/description` to the response with the `4XX` status
- **2026-09-16** `a6a61a29ecdd`: 1 breaking
  - the `errors/items/code` response's property type changed from `string` to `integer`, and format from no format to `int32` for status `4XX`
- **2026-08-17** `1571b0380bd7`: 1 breaking
  - the `errors/items/code` response's property type changed from `integer` to `string`, and format from `int32` to no format for status `4XX`
- **2026-08-04** `8f5f4e537994`: 1 breaking
  - the `errors/items/code` response's property type changed from `string` to `integer`, and format from no format to `int32` for status `4XX`

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/messaging_tollfree/verification/requests/:id/status_history/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/f82938f53ff4?raw)