Get Academy progress
curl --request GET \
--url https://app.famulor.io/api/v1/academy \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.famulor.io/api/v1/academy"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.famulor.io/api/v1/academy', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.famulor.io/api/v1/academy",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.famulor.io/api/v1/academy"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.famulor.io/api/v1/academy")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.famulor.io/api/v1/academy")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"courses": [
{
"id": "ai-voice-agent-foundations",
"level": 1,
"title": "AI Voice Agent Foundations",
"certificate_title": "AI Voice Agent Foundations",
"total_lessons": 8,
"total_minutes": 43,
"locked": false,
"lessons": [
{
"id": "how-agents-work",
"title": "How an AI agent works",
"completed": true,
"completed_at": "2026-10-11T09:12:00Z",
"hints_used": 0
},
{
"id": "engines",
"title": "Pick the right engine",
"completed": true,
"completed_at": "2026-10-11T09:20:00Z",
"hints_used": 1
}
],
"completed_lessons": 8,
"exam_unlocked": true,
"exam": {
"questions": 14,
"pass_score": 11
},
"certificate": {
"credential_id": "FA-7K2M-Q9XD-3HTP",
"course_id": "ai-voice-agent-foundations",
"level": 1,
"holder_name": "Alex Example",
"course_title": "AI Voice Agent Foundations",
"score": 13,
"max_score": 14,
"issued_at": "2026-10-11T10:02:00Z",
"verify_url": "https://app.famulor.io/academy/verify/FA-7K2M-Q9XD-3HTP"
}
},
{
"id": "agentic-workflows",
"level": 2,
"title": "Agentic Workflows & Integrations",
"certificate_title": "Agentic Workflows & Integrations",
"total_lessons": 4,
"total_minutes": 25,
"locked": false,
"lessons": [
{
"id": "flow",
"title": "Design a conversation flow",
"completed": false,
"completed_at": null,
"hints_used": 0
}
],
"completed_lessons": 0,
"exam_unlocked": false,
"exam": {
"questions": 10,
"pass_score": 8
},
"certificate": null
}
],
"certificates_earned": 1
}
}
Account
Get Academy progress
Academy progress of the person who owns the key: every course with its level, lessons (with completion time), whether it is still locked behind an earlier course, whether its final exam is unlocked, the exam size and pass mark, and the certificate (credential ID, name, score, issue date and public verification link) once earned. Lessons and exams are completed in the app. No scope required. Progress is personal: workspace-wide service keys receive 403, as do workspaces where the Academy is not offered.
GET
/
academy
Get Academy progress
curl --request GET \
--url https://app.famulor.io/api/v1/academy \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.famulor.io/api/v1/academy"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.famulor.io/api/v1/academy', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.famulor.io/api/v1/academy",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.famulor.io/api/v1/academy"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.famulor.io/api/v1/academy")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.famulor.io/api/v1/academy")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"courses": [
{
"id": "ai-voice-agent-foundations",
"level": 1,
"title": "AI Voice Agent Foundations",
"certificate_title": "AI Voice Agent Foundations",
"total_lessons": 8,
"total_minutes": 43,
"locked": false,
"lessons": [
{
"id": "how-agents-work",
"title": "How an AI agent works",
"completed": true,
"completed_at": "2026-10-11T09:12:00Z",
"hints_used": 0
},
{
"id": "engines",
"title": "Pick the right engine",
"completed": true,
"completed_at": "2026-10-11T09:20:00Z",
"hints_used": 1
}
],
"completed_lessons": 8,
"exam_unlocked": true,
"exam": {
"questions": 14,
"pass_score": 11
},
"certificate": {
"credential_id": "FA-7K2M-Q9XD-3HTP",
"course_id": "ai-voice-agent-foundations",
"level": 1,
"holder_name": "Alex Example",
"course_title": "AI Voice Agent Foundations",
"score": 13,
"max_score": 14,
"issued_at": "2026-10-11T10:02:00Z",
"verify_url": "https://app.famulor.io/academy/verify/FA-7K2M-Q9XD-3HTP"
}
},
{
"id": "agentic-workflows",
"level": 2,
"title": "Agentic Workflows & Integrations",
"certificate_title": "Agentic Workflows & Integrations",
"total_lessons": 4,
"total_minutes": 25,
"locked": false,
"lessons": [
{
"id": "flow",
"title": "Design a conversation flow",
"completed": false,
"completed_at": null,
"hints_used": 0
}
],
"completed_lessons": 0,
"exam_unlocked": false,
"exam": {
"questions": 10,
"pass_score": 8
},
"certificate": null
}
],
"certificates_earned": 1
}
}
Authorizations
API key (fam_..., created under Settings → API Keys) or an OAuth 2.0 access token (fam_at_...). REST operations also require API Access for the credential's workspace. Keys can be restricted to scopes such as assistants:read, calls:write, campaigns:write, automations:read, dashboards:read, dashboards:write, leads:write, segments:write, loop:read, loop:write, phone_numbers:write, sip_trunks:write, knowledge:write, voices:read, billing:read, billing:write, settings:write, platform:read, platform:write; a *:write scope implies the matching *:read. Automation and dashboard endpoints also accept the legacy calls:* scope. Keys without scope restrictions have full access within the workspace's available capabilities.
Response
Academy progress of the key owner.
Show child attributes
Show child attributes