---
title: "Send an email-ownership verification code"
method: POST
path: "/dir/{dir_id}/verify_email"
tags: ["Email Verification"]
---

# Send an email-ownership verification code

`POST /dir/{dir_id}/verify_email`

Email a 6-digit code to the DIR's authorizer email to confirm ownership of that address.

The code expires in 15 minutes. Requesting a new code invalidates any previous one. Resends are rate limited (a short cooldown plus a daily cap). Submit the code to `POST /dir/{dir_id}/verify_email/confirm`.

## Path parameters

- `dir_id` string, uuid, required

## Response `200`

A code was emailed; the current verification state is returned.

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

## Other responses

- `400` — An error occurred. The response carries the standard Telnyx error envelope.
- `404` — An error occurred. The response carries the standard Telnyx error envelope.
- `429` — An error occurred. The response carries the standard Telnyx error envelope.
- `503` — An error occurred. The response carries the standard Telnyx error envelope.

---

[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/ec31f78cf002/schema)