verification

Submits a single-email verification job.

post/api/verify

Request

  • Base URL: https://api.pricklymails.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.pricklymails.com/api/verify
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Request body

emailstring required

Email address to verify.

Response

Idempotent replay of a prior submission.

emailstring required

Echo of the submitted email address.

estimated_costinteger required

Total tokens reserved for the job.

idempotency_keystring required

Resolved idempotency key.

job_uuidstring required

Public UUID of the persisted job. Use it with GET /api/verify/{uuid} to poll the result.

replayedboolean required

true when the response replays a prior submission made with the same idempotency key and the same email.

statusstring required

Current status of the job (pending, queued, processing, completed, failed, canceled).

suggestionstring nullable

Typo-corrected suggestion for the submitted email (e.g. user@gmial.com -> user@gmail.com), computed synchronously at submit time.

Changes

No recorded changes to this operation across all 1 revision of this API.