---
title: "Retrieve email loop token"
method: POST
path: "/verification/{verificationId}/step/emailLoop/retrieveToken"
tags: ["verification"]
---

# Retrieve email loop token

`POST /verification/{verificationId}/step/emailLoop/retrieveToken`

Optionally creates and returns the current email loop token.

## Path parameters

- `verificationId` string, required

## Request body

- RetrieveEmailLoopTokenRequest — Body of a RetrieveEmailLoopToken request
  - `refreshToken` boolean — If true, regenerate the email loop token before returning it

## Response `200`

Latest email loop token returned

- RetrieveEmailLoopTokenResponse — Body of a RetrieveEmailLoopToken response
  - `token` string — The email loop token for the requested verification

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Verification not found
- `429` — Too many requests. A `429` can mean one of two things — inspect the response body's `errorIds` before retrying: - A transient rate limit applied at the platform edge. If a `Retry-After` header is present, wait that many seconds (using exponential backoff) and retry. - A program/consumer limit such as `verificationLimitExceeded`, `reverificationDailyLimitExceeded`, or `docReviewLimitExceeded` — the consumer has exhausted an allowance defined by the program's limiting policy. This is a permanent rejection (`currentStep: error`, no `Retry-After`); do not retry.
- `500` — Internal server error.
- `503` — Service temporarily unavailable. The request can be safely retried after the interval given in the `Retry-After` header.

---

[API](https://skmtc.dev/sheerid/apis/sheerid-api.md) · [All operations](https://skmtc.dev/sheerid/apis/sheerid-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sheerid/sheerid-api/revisions/dc7f4e84f543/schema)