Integrate 5,000+ courses, eBooks, documentation kits, and certification exams directly into Workday, Docebo, SAP SuccessFactors, Moodle, or your custom corporate LMS.
Exchange your Client ID & Client Secret at POST /api/v1/b2b/oauth/token for a short-lived 1-hour Bearer token.
Pull Courses, Curriculum, eBooks, Documentation Kits, Audio eBooks, and Certification Exams directly into your LMS.
Embed Lucebra Launch Player (Method A) or stream via 2-hour HMAC-signed URLs inside your own player (Method B).
Receive HMAC-signed xAPI completion webhooks in real time or query /api/v1/b2b/reports/progress anytime.
Call POST /api/v1/b2b/launch to generate a 4-hour signed launchUrl or embedUrl (/enterprise-launch). Videos stream securely from Lucebra CDN with DRM protection, curriculum sidebar, and automatic 30-second watch-time heartbeats.
Call POST /api/v1/b2b/stream/sign to receive a 2-hour HMAC-signed stream URL for your own LMS video player, and send playback heartbeats back to POST /api/v1/b2b/tracking/events.
# 1. Request OAuth2 Bearer Token
curl -X POST https://api.lucebra.com/api/v1/b2b/oauth/token \
-H "Content-Type: application/json" \
-d '{"client_id":"<YOUR_CLIENT_ID>","client_secret":"<YOUR_CLIENT_SECRET>"}'
# 2. Sync Published Courses (Workshops excluded)
curl -H "Authorization: Bearer <ACCESS_TOKEN>" \
"https://api.lucebra.com/api/v1/b2b/catalog/courses?page=1&limit=25"
# 3A. Method A: Create Launch Player URL
curl -X POST https://api.lucebra.com/api/v1/b2b/launch \
-H "Authorization: Bearer <ACCESS_TOKEN>" \
-H "Content-Type: application/json" \
-d '{"externalUserKey":"[email protected]","contentType":"Course","contentId":"<COURSE_ID>"}'
# 3B. Method B: Create 2-Hour Signed Stream URL
curl -X POST https://api.lucebra.com/api/v1/b2b/stream/sign \
-H "Authorization: Bearer <ACCESS_TOKEN>" \
-H "Content-Type: application/json" \
-d '{"externalUserKey":"[email protected]","contentType":"Course","contentId":"<COURSE_ID>","lessonId":"<LESSON_ID>"}'// 200 OK (Method A Launch)
{
"launchUrl": "https://www.lucebra.com/enterprise-launch?token=<SIGNED_TOKEN>",
"embedUrl": "https://www.lucebra.com/enterprise-launch?token=<SIGNED_TOKEN>&embed=1",
"expiresAt": "2026-11-16T22:00:00Z"
}
// 403 Forbidden (Subscription expired or cancelled)
{
"error": "subscription_inactive",
"status": "Expired",
"message": "Your Enterprise API subscription is inactive or expired."
}| Method | Endpoint | Required Scope | Description |
|---|---|---|---|
POST | /api/v1/b2b/oauth/token | public (credentials) | Exchange Client ID & Secret for a 1-hour Bearer JWT |
GET | /api/v1/b2b/catalog/courses | catalog:read | List published marketplace courses (Workshops excluded) |
GET | /api/v1/b2b/catalog/courses/{id}/curriculum | catalog:read | Fetch sections, lessons & durations for a course |
GET | /api/v1/b2b/catalog/ebooks | catalog:read | List PDF eBooks, Documentation Kits & Audio eBooks |
GET | /api/v1/b2b/catalog/exams | exams:read | List Certification Exam categories & tracks |
POST | /api/v1/b2b/launch | catalog:read | Method A: Generate 4-hour signed Launch / Embed Player URL |
POST | /api/v1/b2b/stream/sign | catalog:read | Method B: Generate 2-hour HMAC-signed stream URL |
POST | /api/v1/b2b/tracking/events | tracking:write | Record watch/read seconds & trigger xAPI completion webhooks |
GET | /api/v1/b2b/reports/progress | reports:read | Pull learner progress & completion metrics |
import crypto from 'crypto';
export function verifyLucebraWebhook(rawBody: string, signatureHeader: string, webhookSecret: string): boolean {
const expected = 'sha256=' + crypto.createHmac('sha256', webhookSecret).update(rawBody).digest('hex');
return crypto.timingSafeEqual(Buffer.from(signatureHeader), Buffer.from(expected));
}| HTTP | Error Code | Behavior |
|---|---|---|
| 200 OK | — | Request succeeded |
| 401 Unauthorized | invalid_client / token_expired | Invalid credentials, revoked client, or expired Bearer token |
| 403 Forbidden | subscription_inactive | Subscription expired or cancelled — access halted immediately |
| 403 Forbidden | seat_limit_exceeded | 30-day rolling active seat limit reached |
| 403 Forbidden | insufficient_scope | Client key lacks the required API scope |
| 404 Not Found | course_not_found / media_not_found | Requested course, lesson, or media item not found |
Every OAuth token request, catalog sync, launch URL, and signed stream validates your live BusinessPlan status in real time. Cancelled or expired plans immediately receive 403 subscription_inactive until renewed.
Enterprise API includes 1,000 requests/min SLA, 30-day rolling active learner seat tracking (externalUserKey), and automatic Sandbox test keys. E-Workshops, LMS UI, and Skill-Matrix remain excluded from standalone API (70%) packages.