API Authentication Guide

Overview

Every API request must include an X-API-Key header. Apixies offers two ways to get a key — one requires no signup at all.

1. Temporary API Keys

Temporary keys let you integrate the API without creating an account. Generate one from the homepage.

• Quota: 200 requests total
• Expires after 7 days
• Daily limit: 20 requests/day
• Max 3 keys per IP address
• Key prefix: tmpk_

curl -H "X-API-Key: tmpk_abc123..." \
  https://apixies.com/api/v1/inspect-ssl?domain=github.com

2. Registered API Keys

Create a free account for higher limits and permanent API keys. Manage your keys from the API Keys dashboard.

• Daily limit: 75 requests/day
• No total quota cap — resets daily
• Keys are managed via Laravel Sanctum

curl -H "X-API-Key: YOUR_API_KEY" \
  https://apixies.com/api/v1/inspect-email?email=test@example.com

Rate Limits

Apixies enforces multiple layers of rate limiting to ensure fair usage and platform stability.

Authentication Errors

When authentication fails, the API returns a JSON error response with an appropriate HTTP status code.

401 Unauthorized

Returned when the API key is missing, invalid, or expired.

{
  "status": "error",
  "code": "MISSING_AUTH",
  "message": "Missing API key. Include X-API-Key header.",
  "http_code": 401
}

Other 401 error codes:

• INVALID_API_KEY — API key not found
• INVALID_TEMP_KEY — temporary key not found
• TEMP_KEY_EXPIRED — temporary key has expired

429 Too Many Requests

Returned when any rate limit or quota is exceeded.

{
  "status": "error",
  "code": "DAILY_QUOTA_EXCEEDED",
  "message": "Daily request limit reached. Sign up for a free account for higher limits.",
  "daily_limit": 20,
  "http_code": 429
}

Other 429 error codes:

• TEMP_KEY_QUOTA_EXCEEDED — temporary key calls exhausted
• RATE_LIMITED — global rate cap exceeded (retry shortly)

Request Headers