Account & API Keys

Manage your account information, credits, and API keys programmatically.

Get Account Info

GET/v1/account

Retrieve your account details, credit balance, and usage statistics.

Response

{
  "success": true,
  "data": {
    "user": {
      "user_id": "usr_abc123",
      "email": "user@example.com",
      "name": "John Doe",
      "plan": "professional",
      "status": "active",
      "created_at": "2025-06-15T10:00:00Z"
    },
    "credits": {
      "balance": 24500,
      "used_this_month": 500,
      "monthly_limit": 25000
    },
    "usage": {
      "verifications_today": 150,
      "verifications_this_month": 4500,
      "cache_hit_rate": 0.32
    }
  }
}

List API Keys

GET/v1/api-keys

List all API keys associated with your account.

Response

{
  "success": true,
  "data": {
    "keys": [
      {
        "key_id": "key_abc123",
        "name": "Production",
        "prefix": "kw_live_abc1",
        "created_at": "2025-06-15T10:00:00Z",
        "last_used_at": "2026-02-03T14:30:00Z",
        "status": "active"
      },
      {
        "key_id": "key_def456",
        "name": "Development",
        "prefix": "kw_test_def4",
        "created_at": "2025-07-01T12:00:00Z",
        "last_used_at": null,
        "status": "active"
      }
    ]
  }
}

Create API Key

POST/v1/api-keys

Request Body

Parameter	Type	Required	Description
`name`	string	Yes	A name to identify this key

Important: The full API key is only shown once in the response. Store it securely.

Response

{
  "success": true,
  "data": {
    "key_id": "key_xyz789",
    "name": "Mobile App",
    "key": "kw_live_xyz789abcdef123456...",
    "prefix": "kw_live_xyz7",
    "created_at": "2026-02-03T15:00:00Z"
  }
}

Revoke API Key

DELETE/v1/api-keys/{key_id}

Permanently revoke an API key. This action cannot be undone.

Response

{
  "success": true,
  "data": {
    "message": "API key revoked successfully"
  }
}

Credit Balance

Monitor your credit usage to ensure uninterrupted service.

Credit Consumption

1 credit: Single email verification (cache miss)
0.5 credits: Cached result (within 24 hours)
1 credit: Each email in batch verification
Free: Job status checks, account info