List All Published Courses in Your Academy via API

The courses endpoint returns every published course in your academy in display order. You can use this to build custom catalog pages, sync course data to an external system, or display your catalog programmatically. Only published courses are returned; drafts are never included.

List courses

string

required

Your API key as a Bearer token. See Authentication for details.

GET /api/v1/courses

This endpoint takes no query parameters and no request body.

Response fields

All response data is nested under a top-level data object.

object

required

Hide properties

object[]

required

Array of course objects, ordered by display order set in the dashboard.

Hide course properties

string

required

UUID of the course.

string

required

Display title of the course.

string

required

URL-safe identifier for the course, unique within the academy.

string

Short description of the course. May be null if not set.

string

required

Visibility setting for the course. Possible values: published, hidden.

string

required

The course’s access mode. free means any member of your academy can open it. offer_only means it stays locked unless something grants it: a purchase, a course assignment, or an offer the student holds.

number

required

Number of published lessons in the course.

number

required

Sum of all published lesson reading times in minutes.

This endpoint does not return course pricing. Manage and read prices from the course’s Access settings in the dashboard.

Example request

curl https://yourname.fayneos.com/api/v1/courses \
  -H "Authorization: Bearer fa_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

const response = await fetch('https://yourname.fayneos.com/api/v1/courses', {
  headers: {
    'Authorization': 'Bearer fa_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
  }
});
const { data } = await response.json();

Example response

{
  "data": {
    "courses": [
      {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "title": "Cold Outreach Mastery",
        "slug": "cold-outreach-mastery",
        "description": "Master the full cold outreach workflow from prospecting to reply.",
        "visibility": "published",
        "access": "free",
        "lesson_count": 12,
        "total_reading_time_minutes": 95
      },
      {
        "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "title": "First-Time Manager Foundations",
        "slug": "first-time-manager-foundations",
        "description": "Core skills every new manager needs in their first 90 days.",
        "visibility": "published",
        "access": "offer_only",
        "lesson_count": 8,
        "total_reading_time_minutes": 60
      }
    ]
  }
}

Authentication

Endpoints

Guides

List All Published Courses in Your Academy via API

List courses

Response fields

Example request

Example response

​List courses

​Response fields

​Example request

​Example response

List courses

Response fields

Example request

Example response