Documentation
Welcome to the AIcores API documentation. Get started in minutes with our simple REST APIs.
Getting Started
1. Create a free account to get your API key.
2. Include your API key in the x-api-key header of every request.
3. Make your first request:
Your first request
-blue-400 font-semibold">curl -X GET -emerald--amber-400">400">"https://api.aicores.io/v1/email/validate?email=hello@example.com" \
-H -emerald--amber-400">400">"x-api-key: YOUR_API_KEY"Authentication
All API requests require authentication via the x-api-key header. You can find and manage your API keys in the Dashboard.
# Include in every request
-H -emerald--amber-400">400">"x-api-key: sk_live_abc123..."Security: Never expose your API key in client-side code. Always make API calls from your server or backend.
Rate Limits
Rate limits are applied per API key. When you exceed the limit, the API returns a 429 Too Many Requests response. Check the following headers in every response:
| Header | Description |
|---|---|
| X-RateLimit-Limit | Maximum requests per minute for your plan |
| X-RateLimit-Remaining | Requests remaining in the current window |
| X-RateLimit-Reset | Unix timestamp when the limit resets |