Credits Balance

Check your current account validation credit balance and usage.

Endpoint

GET /v1/credits

Authentication

Requires API Key via X-API-Key header.

Request

curl -X GET https://api.status-check.io/v1/credits \
  -H "X-API-Key: sk_your_api_key"

Response

{
  "userId": "user_abc123xyz",
  "credits": 1500.0,
  "updatedAt": "2026-06-20T15:30:00Z"
}

Response Fields

Field	Type	Description
userId	string	Your unique user identifier
credits	float	Current credit balance. Each validation costs 0.001 credits (1 credit = 1,000 validations)
updatedAt	string (ISO 8601)	Timestamp of last credit balance update

Credit Pricing

• 1 credit = 1,000 validations
• $1 = 1,000 validations
• Credits never expire
• No monthly subscriptions

Examples:

• 1 lead validation = 0.001 credits
• 500 leads = 0.5 credits ($0.50)
• 10,000 leads = 10 credits ($10.00)

Use Cases

Check balance before bulk validation:

const { credits } = await getCredits();
const leadsToValidate = 5000;
const creditsNeeded = leadsToValidate / 1000;

if (credits < creditsNeeded) {
  console.log(`Insufficient credits. Need ${creditsNeeded}, have ${credits}`);
  // Redirect to purchase credits
}

Monitor credit usage:

// Check credits before and after validation
const before = await getCredits();
await validateLeads(leadIds);
const after = await getCredits();
const used = before.credits - after.credits;
console.log(`Used ${used} credits for ${leadIds.length} leads`);

Low balance alerts:

const { credits } = await getCredits();
if (credits < 10) {
  // Send alert: less than 10,000 validations remaining
  sendLowCreditAlert(credits);
}

Rate Limits

• 60 requests per minute
• 1,000 requests per hour

Errors

Status Code	Error	Description
401	Unauthorized	Missing or invalid API key
404	Not Found	User account not found

Purchase Credits

Purchase credits via the dashboard or contact support@status-check.io for enterprise pricing.