API Overview

Base URL

https://safua.ai/api/v1

All endpoints require authentication. See Authentication for details.

All responses return JSON. Successful responses include a data field. Errors include a detail field.

// Success
{
  "data": { ... }
}

// Error
{
  "detail": "Not authenticated"
}

Plan	Requests per minute
Free	30
Pro	120

Rate limit headers are included on every response:

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 118
X-RateLimit-Reset: 1735689600

List endpoints support cursor-based pagination:

GET /api/v1/courses?limit=20&cursor=eyJpZCI6MTAwfQ==

Response includes a next_cursor field when more results exist.

The current API version is v1. Breaking changes will be released as v2 with a deprecation notice and 90-day migration window.