VERIFICATION_COOLDOWN

429rate_limit

A verification code was requested too soon after the last one.

Cause

Code sends are rate-limited per address to keep the mailbox from being flooded.

How to fix it

Wait out the cooldown window. The previously sent code is still valid, so prefer using it over re-sending.

Example response

429 VERIFICATION_COOLDOWN

JSON

{
  "error_code": "VERIFICATION_COOLDOWN",
  "error_type": "rate_limit",
  "error_message": "A verification code was requested too soon after the last one.",
  "hint": "Wait out the cooldown window. The previously sent code is still valid, so prefer using it over re-sending.",
  "docs_url": "https://docs.billerapi.com/errors/VERIFICATION_COOLDOWN",
  "request_id": "d94f5e2a-8c3b-4f1e-9a7d-6b2c1e0f8a34",
  "retry_after": 30
}

Error handling — the error envelope shape and how to parse it
Error code reference — every stable error code

Canonical docs URL: https://docs.billerapi.com/errors/VERIFICATION_COOLDOWN

Was this page helpful?

VERIFICATION_COOLDOWN

Cause

How to fix it

Example response

429 VERIFICATION_COOLDOWN

Related