Skip to content

Get Verification Credits

The workspace's email verification credit balance.

GET/api/v1/verification/credits

Requires an API key with the read scope.

This response is not wrapped in data.

Response#

balanceinteger
Credits remaining across unexpired batches.
expiresAtstring
ISO 8601 timestamp of the nearest expiry, or null.

Errors#

StatusDescription
401Missing, invalid, revoked or expired API key
403API key does not have the required scope: read

Rate Limit#

  • 600 requests per minute, shared by every poll call in your workspace. Fixed 60-second window.
  • Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (unix epoch seconds) and X-RateLimit-Bucket (poll).
  • A 429 response includes a Retry-After header (seconds until the bucket resets).

For client-side patterns (Retry-After, exponential backoff, monitoring X-RateLimit-Remaining), see Rate Limiting.

Was this page helpful?
View as MarkdownLast updated November 6, 2026