Read Email Verification Code

TypeScriptUtility

POST api.upapi.io/email-read-verification-code.post

Connect to an IMAP mailbox and extract a verification code from the SUBJECT of a recent email. Polls with retries. Supports Gmail (with App Password), Outlook, and any IMAP server. Generic — works for any platform that puts its code in the subject line; for a token that only appears in the body, use email-read-verification-link.

emailverificationimaputility

AuthAPI key

Cost1 unit

Timeout120s

CacheNone

Request schema

Field	Type	Description
`imapHost`	string	IMAP server hostname· default: `"imap.gmail.com"`
`imapPass`req	string	IMAP password or app password
`imapPort`	integer	IMAP server port· default: `993`
`imapUser`req	string	IMAP username (email address)
`maxRetries`	integer	Number of polling attempts· default: `5`
`codePattern`	string	Regex to extract a verification code from the email SUBJECT (the body is not fetched — use email-read-verification-link for body tokens)· default: `"\\b(\\d{6})\\b"`
`retryDelayMs`	integer	Milliseconds between retry attempts· default: `10000`
`senderFilter`req	string	Filter emails by sender (e.g. noreply@redditmail.com)
`maxAgeMinutes`	integer	Only look at emails received within this many minutes· default: `15`
`subjectPattern`	string	Regex pattern to match subject line
`recipientFilter`	string	Filter by recipient address (useful with catch-all domains)

Response schema

Field	Type	Description
`to`req	string	Recipient address
`code`req	string	Extracted verification code
`from`req	string	Sender address
`subject`req	string	Email subject line
`elapsedMs`req	integer
`fetchedAt`req	string
`receivedAt`req	string	When the email was received

Try it

imapPassrequired

IMAP password or app password

imapUserrequired

IMAP username (email address)

senderFilterrequired

Filter emails by sender (e.g. noreply@redditmail.com)

imapHostoptional· default: imap.gmail.com

IMAP server hostname

imapPortoptional· default: 993

IMAP server port

maxRetriesoptional· default: 5

Number of polling attempts

codePatternoptional· default: \b(\d{6})\b

Regex to extract a verification code from the email SUBJECT (the body is not fetched — use email-read-verification-link for body tokens)

retryDelayMsoptional· default: 10000

Milliseconds between retry attempts

maxAgeMinutesoptional· default: 15

Only look at emails received within this many minutes

subjectPatternoptional

Regex pattern to match subject line

recipientFilteroptional

Filter by recipient address (useful with catch-all domains)

Run this endpoint live

Jump in as a guest — no signup — and run email-read-verification-code.post with your own inputs. Create a free account anytime to get your own API key.

Code examples

curl -X POST https://api.upapi.io/email-read-verification-code.post \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{ "imapHost": "imap.gmail.com", "imapPass": "example", "imapPort": 993, "imapUser": "example", "maxRetries": 5, "codePattern": "\\b(\\d{6})\\b", "retryDelayMs": 10000, "senderFilter": "noreply@redditmail.com", "maxAgeMinutes": 15 }'

Developer tools

OpenAPI specImport the spec or collection into Postman, Insomnia, or any codegen tool.