Skip to main content

Authentication

Learn about authentication methods for the Status Check API.

Authentication Methods​

Status Check supports two authentication methods:

The primary authentication method for API access.

How to use:

curl -X POST https://api.status-check.io/v1/check \
-H "X-API-Key: sk_your_api_key" \
-H "Content-Type: application/json" \
-d '{"domain": "example.com"}'

Benefits:

  • Simple to implement
  • No token expiration
  • Easy to rotate
  • Per-application isolation

See the API Keys guide for detailed information.

2. OAuth Bearer Token​

Use your Firebase authentication token for dashboard-related operations.

How to use:

curl -X GET https://api.status-check.io/v1/leads \
-H "Authorization: Bearer your_firebase_token"

When to use:

  • Building custom dashboards
  • Integrating with user authentication
  • Server-to-server with Firebase

Security Best Practices​

  1. Never expose credentials in client-side code
  2. Use environment variables to store API keys
  3. Implement key rotation regularly
  4. Monitor usage for suspicious activity
  5. Use HTTPS only for all API requests

Common Errors​

Invalid API Key​

Error:

{
"error": "Invalid API key",
"message": "The provided API key is invalid or has been revoked."
}

HTTP Status: 401 Unauthorized

Solution: Verify your API key and ensure it hasn't been revoked.

Missing Authentication​

Error:

{
"error": "Missing authentication",
"message": "No API key provided in request."
}

HTTP Status: 401 Unauthorized

Solution: Include the X-API-Key header in your request.

Next Steps​

Support​

Authentication issues? Contact support@status-check.io