Status Endpoint

The status endpoint returns information about your current quota.


GET/v1/status

Check API Status

This status endpoint returns information about your current quota.

Response Properties

  • Name
    account_id
    Type
    integer
    Description

    The ID of the account the API key belongs to.

  • 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.

Request

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

Response

{
    "account_id": 313373133731337,
    "quotas": {
        "month": {
            "total": 300,
            "used": 72,
            "remaining": 228
        },
        "grace": {
            "total": 0,
            "used": 0,
            "remaining": 0
        }
    }
}