Skip to main content
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

​
header.Authorization
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.
​
data
object
required
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"

​
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",
        "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",
        "lesson_count": 8,
        "total_reading_time_minutes": 60
      }
    ]
  }
}