Skip to content
API & IntegrationsDocumentation

API: Auth and Health

Authentication, rate limit headers, and the public health check endpoint.

Health Check

GET/v1/health

Public endpoint — no API key required. Use this to verify connectivity before running automated workflows.

curl https://api.ablelytics.com/v1/health

Response

{
  "status": "ok",
  "version": "v1"
}

Status Codes

200 OK

Authentication

Protected routes require an x-api-key header containing your API key. Generate your key from Workspace → API Settings.

  • Invalid or missing key → 401 Unauthorized
  • Valid key, plan without API access → 403 Forbidden
  • API access requires the Starter plan or higher.

Rate Limit Headers

Every successful response includes these headers so you can track usage:

  • X-RateLimit-Limit — your plan's daily call limit
  • X-RateLimit-Remaining — calls remaining today
  • X-RateLimit-Reset — ISO timestamp of the midnight UTC reset