Status Endpoint

The status endpoint returns information about your current quota and the plan of your account.

Requests to this endpoint are free: they do not count against your quota or your minute rate limit. While your key is blocked, because your quota is used up or the free plan's minute rate limit is reached, this endpoint is answered with 429 like every other endpoint.

GET/v1/status

Check API Status

This status endpoint returns information about your current quota and the plan of your account.

Response Properties

Name
account_id
Type
integer
Description
The ID of the account the API key belongs to.
Name
account_id_str
Type
string
Description
The same id as account_id, as a string for JavaScript clients, whose numbers lose precision above 2^53.
Name
quotas
Type
object
Description
Contains information about your request quota. Each bucket reports total, used and remaining requests (used + remaining = total).
Name
quotas.month
Type
object
Description
Your monthly request quota, as defined by your plan.
Name
quotas.grace
Type
object
Description
Your grace quota — a temporary allowance we grant while a billing issue (e.g. a failed payment) is being resolved, so your integration keeps working. It is 0 unless a grace period is active.
Name
plan
Type
object
Description
The plan of the account: name, interval, price_id, free, custom, status (of the subscription, e.g. active), renews_at, scheduled (a plan change that starts later, or null), upgrade_url (null for a custom plan) and plans_url (every plan as JSON). Use it to check that an upgrade took effect.

Request

GET

/v1/status

curl -G https://api.emailvalidation.io/v1/status \
    -H "apikey: YOUR-API-KEY"

Response

{
    "account_id": 313373133731337,
    "account_id_str": "313373133731337",
    "quotas": {
        "month": {
            "total": 100,
            "used": 72,
            "remaining": 28
        },
        "grace": {
            "total": 0,
            "used": 0,
            "remaining": 0
        }
    },
    "plan": {
        "name": "free",
        "interval": "month",
        "price_id": "price_1AbCdEfGhIjKlMnOpQrStUvW",
        "free": true,
        "custom": false,
        "status": "active",
        "renews_at": "2026-11-01T00:00:00+00:00",
        "scheduled": null,
        "upgrade_url": "https://app.emailvalidation.io/upgrade?utm_source=agent&utm_campaign=status&team=313373133731337",
        "plans_url": "https://api.emailvalidation.io/v1/agent/plans"
    }
}