---
title: "Get email-ownership verification status"
method: GET
path: "/dir/{dir_id}/verify_email"
tags: ["Email Verification"]
---

# Get email-ownership verification status

`GET /dir/{dir_id}/verify_email`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/dir/{dir_id}/verify_email`
- Auth: HTTP bearer

Whether the DIR's current authorizer email has been verified.

## Path parameters

- `dir_id` string, uuid, required

## Response `200`

The current verification state.

- EmailVerificationStatusWrapped
  - `data` EmailVerificationStatus, required: Verification state for a DIR's authorizer email.
    - `record_type` 'email_verification', required: Always `email_verification`.
    - `email_verified` boolean, required: Whether the DIR's authorizer email has been confirmed.
    - `status` 'sent' | 'verified' | 'unverified', required: `sent` after a code is emailed; `verified` after a successful confirm; `unverified` when no verification is in progress.
    - `expires_at` string, date-time, nullable: When the outstanding code stops being accepted. Null when no verification is in progress.
    - `sends_remaining_today` integer, nullable: How many more codes may be requested for this DIR today. Null when the daily cap does not apply.

## Other responses

- `404`: An error occurred. The response carries the standard Telnyx error envelope.

## Changes

- **2026-10-15** `a72569d69430`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/dir/:dir_id/verify_email/get.md)

---

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