Developers

API Reference

Build custom integrations with the Tristar Academy REST API. Manage users, courses, reports, and automations programmatically.

Quick Start

Authentication

All API requests require a Bearer token. Generate your API key from Settings → API Keys in your admin dashboard.

Include the token in the Authorization header of every request.

Example request
curl -X GET https://api.tristar-academy.com/v1/users \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
Response
{
  "data": [
    {
      "id": "usr_abc123",
      "name": "Ahmed Al-Rashidi",
      "email": "ahmed@company.com",
      "role": "learner",
      "department": "Engineering"
    }
  ],
  "meta": { "total": 142, "page": 1 }
}
Endpoints

Key Endpoints

GET/api/v1/users
POST/api/v1/users
GET/api/v1/courses
POST/api/v1/courses/{id}/enroll
GET/api/v1/reports/gap-analysis
GET/api/v1/certificates
POST/api/v1/webhooks
GET/api/v1/departments

Full documentation with request/response schemas, pagination, and error codes coming soon.

Rate Limits

1,000 requests per minute for Growth plans. 10,000/min for Enterprise. Rate limit headers included in every response.

Versioning

The API is versioned via URL path (/v1/). Breaking changes are released as new versions with 6 months of parallel support.

Webhooks

Subscribe to events like course.completed, certificate.expired, and user.created. Webhook payloads are signed with HMAC-SHA256.

Ready to Integrate?

Get your API key and start building. Our developer support team is here to help.

No credit card · Free plan never expires