API Authentication

The Spark! API uses API keys for authentication. Include your API key in the Authorization header of every request.

1. Navigate to Settings → API → API Keys
2. Click "Create API Key"
3. Name your key (e.g., "Production", "Staging")
4. Set permissions (read-only or read-write)
5. Copy and securely store the key

Include the API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

API requests are rate limited:

• Standard — 100 requests per minute
• Bulk operations — 10 requests per minute
• Webhooks — Unlimited (outbound)

Rate limit headers are included in every response:

• X-RateLimit-Limit — Maximum requests allowed
• X-RateLimit-Remaining — Requests remaining
• X-RateLimit-Reset — Unix timestamp when limit resets

API errors return standard HTTP status codes:

• 400 — Bad request (invalid parameters)
• 401 — Unauthorized (invalid or missing API key)
• 403 — Forbidden (insufficient permissions)
• 404 — Not found
• 429 — Too many requests (rate limited)
• 500 — Server error

• Production — https://api.chargezen.com/spark/v1
• Sandbox — https://sandbox.chargezen.com/spark/v1