> ## Documentation Index
> Fetch the complete documentation index at: https://help.kajabi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List courses

> List of courses that can be offered to a contact or purchased
## Pagination
Use the `page[number]` and `page[size]` query parameters to paginate results:
### Get first page of 10 items
* `GET /v1/courses?page[number]=1&page[size]=10`
### Get second page of 25 items
* `GET /v1/courses?page[number]=2&page[size]=25`

The response includes pagination links and meta data:
```json
{
  "links": {
    "self": "https://api.kajabi.com/v1/courses?page[number]=2&page[size]=10",
    "first": "https://api.kajabi.com/v1/courses?page[number]=1&page[size]=10",
    "prev": "https://api.kajabi.com/v1/courses?page[number]=1&page[size]=10",
    "next": "https://api.kajabi.com/v1/courses?page[number]=3&page[size]=10",
    "last": "https://api.kajabi.com/v1/courses?page[number]=5&page[size]=10"
  },
  "meta": {
    "total_pages": 5,
    "total_count": 50,
    "current_page": 2
  }
}
```
## Sorting
Use the `sort` parameter to sort the results:
### Sort by title in ascending order
* `GET /v1/courses?sort=title`
### Sort by title in descending order
* `GET /v1/courses?sort=-title`

Response will include courses sorted by the specified field
```json
{
  "data": [
    {
      "id": "123",
      "type": "courses",
      "attributes": {
        "title": "Advanced Marketing",
        "description": "Master level marketing course",
        "status": "active"
      }
    },
    {
      "id": "456",
      "type": "courses",
      "attributes": {
        "title": "Marketing Basics",
        "description": "Introduction to marketing",
        "status": "active"
      }
    }
  ]
}
```
## Sparse Fields
Use the `fields` parameter to request only specific attributes:
### Only return title and thumbnail_url attributes
* `GET /v1/courses?fields[courses]=title,thumbnail_url`

Response will only include requested fields
```json
{
  "data": [{
    "id": "123",
    "type": "courses",
    "attributes": {
      "title": "Marketing Fundamentals",
      "thumbnail_url": "https://example.com/thumbnail.jpg"
    }
  }]
}
```
## Filter by Site ID
Use the `filter[site_id]` parameter to get courses for a specific site:
### Get courses for site with ID 123
* `GET /v1/courses?filter[site_id]=123`

Response will only include courses for that site
```json
{
  "data": [{
    "id": "456",
    "type": "courses",
    "attributes": {
      "title": "Marketing Fundamentals",
      "description": "Introduction to marketing concepts",
      "status": "active"
    },
    "relationships": {
      "site": {
        "data": {
          "id": "123",
          "type": "sites"
        }
      }
    }
  }]
}
```
## Filter by Title Contains
Use the `filter[title_cont]` parameter to find courses where the title contains specific text:
### Get courses with titles containing "marketing"
* `GET /v1/courses?filter[title_cont]=marketing`

Response will include courses with matching titles
```json
{
  "data": [{
    "id": "456",
    "type": "courses",
    "attributes": {
      "title": "Marketing Fundamentals",
      "description": "Introduction to marketing concepts",
      "status": "active"
    }
  }]
}
```
## Filter by Description Contains
Use the `filter[description_cont]` parameter to find courses where the description contains specific text:
### Get courses with descriptions containing "marketing"
* `GET /v1/courses?filter[description_cont]=marketing`

Response will include courses with matching descriptions
```json
{
  "data": [{
    "id": "456",
    "type": "courses",
    "attributes": {
      "title": "Marketing Fundamentals",
      "description": "Introduction to marketing concepts and strategies",
      "status": "active"
    }
  }]
}
```
## Using Multiple Parameters Together
You can combine pagination, sparse fields, filtering and sorting in a single request:
### Get first page of 10 courses for site 123, sorted by title, showing only specific fields
* `GET /v1/courses?page[number]=1&page[size]=10&filter[site_id]=123&sort=title&fields[courses]=title,thumbnail_url`

Response will include pagination, sorted filtered results with requested fields
```json
{
  "data": [{
    "id": "456",
    "type": "courses",
    "attributes": {
      "title": "Advanced Marketing",
      "thumbnail_url": "https://example.com/thumbnail1.jpg"
    }
  },
  {
    "id": "789",
    "type": "courses",
    "attributes": {
      "title": "Marketing Basics",
      "thumbnail_url": "https://example.com/thumbnail2.jpg"
    }
  }],
  "links": {
    "self": "https://api.kajabi.com/v1/courses?page[number]=1&page[size]=10&filter[site_id]=123&sort=title&fields[courses]=title,thumbnail_url",
    "first": "https://api.kajabi.com/v1/courses?page[number]=1&page[size]=10&filter[site_id]=123&sort=title&fields[courses]=title,thumbnail_url",
    "next": "https://api.kajabi.com/v1/courses?page[number]=2&page[size]=10&filter[site_id]=123&sort=title&fields[courses]=title,thumbnail_url",
    "last": "https://api.kajabi.com/v1/courses?page[number]=3&page[size]=10&filter[site_id]=123&sort=title&fields[courses]=title,thumbnail_url"
  },
  "meta": {
    "total_pages": 3,
    "total_count": 25,
    "current_page": 1
  }
}
```




## OpenAPI

````yaml /openapi.yaml get /v1/courses
openapi: 3.1.1
info:
  title: Kajabi API V1
  version: 1.0.1
  description: >
    ## Public API

    * Server URL `https://api.kajabi.com`

    * Endpoint paths are prefixed with `/v1`

    * Version endpoint `GET https://api.kajabi.com/v1/version`

    * See the [Developers Site](https://developers.kajabi.com) for documentation
    and examples.

    * Try the demo [Postman
    collection](https://www.postman.com/kajabi-apis/beta-public-api-demo/collection/fg4iyaz/kajabi-public-api-v1)

    ## API Keys

    * Your API `client_id` and `client_secret` are available on the [User API
    Keys](https://app.kajabi.com/admin/settings/security) section of the Kajabi
    Admin Portal.
      * Custom API Keys can be created with specific permissions.
      * Click the "Create User API Key" button, enter a name (e.g. "My project"), select the user and permissions, and click "Create".
      * For security purposes, you may "Delete" or "Rotate" the api credentials at any time; which will invalidate any access tokens granted with the credentials.
    ## Video Walkthroughs

    *
    [Capabilities](https://drive.google.com/file/d/1Puc9B2sSdA-RQb7YMxmUXg4FVoEXytoc/view?usp=sharing)

    * [Getting
    Started](https://drive.google.com/file/d/1hbGRShkxven_QMWvgYrerHKURbcZrnvJ/view?usp=sharing)

    * [Error
    Examples](https://drive.google.com/file/d/1i0wQK71I1jpaZVsxYwsn62gVj40S_E7Y/view?usp=sharing)

    * [External Contact
    Form](https://drive.google.com/file/d/1HqpULXvan5TOK3LvM7nILCuCkCaX0kFT/view?usp=sharing)
  contact:
    email: support@kajabi.com
    name: Support
    url: >-
      https://help.kajabi.com/hc/en-us/articles/4404549690523-How-to-Get-Help-From-Kajabi-Live-Agents
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://api.kajabi.com
    description: Production
security: []
paths:
  /v1/courses:
    get:
      tags:
        - Courses
      summary: List courses
      description: >
        List of courses that can be offered to a contact or purchased

        ## Pagination

        Use the `page[number]` and `page[size]` query parameters to paginate
        results:

        ### Get first page of 10 items

        * `GET /v1/courses?page[number]=1&page[size]=10`

        ### Get second page of 25 items

        * `GET /v1/courses?page[number]=2&page[size]=25`


        The response includes pagination links and meta data:

        ```json

        {
          "links": {
            "self": "https://api.kajabi.com/v1/courses?page[number]=2&page[size]=10",
            "first": "https://api.kajabi.com/v1/courses?page[number]=1&page[size]=10",
            "prev": "https://api.kajabi.com/v1/courses?page[number]=1&page[size]=10",
            "next": "https://api.kajabi.com/v1/courses?page[number]=3&page[size]=10",
            "last": "https://api.kajabi.com/v1/courses?page[number]=5&page[size]=10"
          },
          "meta": {
            "total_pages": 5,
            "total_count": 50,
            "current_page": 2
          }
        }

        ```

        ## Sorting

        Use the `sort` parameter to sort the results:

        ### Sort by title in ascending order

        * `GET /v1/courses?sort=title`

        ### Sort by title in descending order

        * `GET /v1/courses?sort=-title`


        Response will include courses sorted by the specified field

        ```json

        {
          "data": [
            {
              "id": "123",
              "type": "courses",
              "attributes": {
                "title": "Advanced Marketing",
                "description": "Master level marketing course",
                "status": "active"
              }
            },
            {
              "id": "456",
              "type": "courses",
              "attributes": {
                "title": "Marketing Basics",
                "description": "Introduction to marketing",
                "status": "active"
              }
            }
          ]
        }

        ```

        ## Sparse Fields

        Use the `fields` parameter to request only specific attributes:

        ### Only return title and thumbnail_url attributes

        * `GET /v1/courses?fields[courses]=title,thumbnail_url`


        Response will only include requested fields

        ```json

        {
          "data": [{
            "id": "123",
            "type": "courses",
            "attributes": {
              "title": "Marketing Fundamentals",
              "thumbnail_url": "https://example.com/thumbnail.jpg"
            }
          }]
        }

        ```

        ## Filter by Site ID

        Use the `filter[site_id]` parameter to get courses for a specific site:

        ### Get courses for site with ID 123

        * `GET /v1/courses?filter[site_id]=123`


        Response will only include courses for that site

        ```json

        {
          "data": [{
            "id": "456",
            "type": "courses",
            "attributes": {
              "title": "Marketing Fundamentals",
              "description": "Introduction to marketing concepts",
              "status": "active"
            },
            "relationships": {
              "site": {
                "data": {
                  "id": "123",
                  "type": "sites"
                }
              }
            }
          }]
        }

        ```

        ## Filter by Title Contains

        Use the `filter[title_cont]` parameter to find courses where the title
        contains specific text:

        ### Get courses with titles containing "marketing"

        * `GET /v1/courses?filter[title_cont]=marketing`


        Response will include courses with matching titles

        ```json

        {
          "data": [{
            "id": "456",
            "type": "courses",
            "attributes": {
              "title": "Marketing Fundamentals",
              "description": "Introduction to marketing concepts",
              "status": "active"
            }
          }]
        }

        ```

        ## Filter by Description Contains

        Use the `filter[description_cont]` parameter to find courses where the
        description contains specific text:

        ### Get courses with descriptions containing "marketing"

        * `GET /v1/courses?filter[description_cont]=marketing`


        Response will include courses with matching descriptions

        ```json

        {
          "data": [{
            "id": "456",
            "type": "courses",
            "attributes": {
              "title": "Marketing Fundamentals",
              "description": "Introduction to marketing concepts and strategies",
              "status": "active"
            }
          }]
        }

        ```

        ## Using Multiple Parameters Together

        You can combine pagination, sparse fields, filtering and sorting in a
        single request:

        ### Get first page of 10 courses for site 123, sorted by title, showing
        only specific fields

        * `GET
        /v1/courses?page[number]=1&page[size]=10&filter[site_id]=123&sort=title&fields[courses]=title,thumbnail_url`


        Response will include pagination, sorted filtered results with requested
        fields

        ```json

        {
          "data": [{
            "id": "456",
            "type": "courses",
            "attributes": {
              "title": "Advanced Marketing",
              "thumbnail_url": "https://example.com/thumbnail1.jpg"
            }
          },
          {
            "id": "789",
            "type": "courses",
            "attributes": {
              "title": "Marketing Basics",
              "thumbnail_url": "https://example.com/thumbnail2.jpg"
            }
          }],
          "links": {
            "self": "https://api.kajabi.com/v1/courses?page[number]=1&page[size]=10&filter[site_id]=123&sort=title&fields[courses]=title,thumbnail_url",
            "first": "https://api.kajabi.com/v1/courses?page[number]=1&page[size]=10&filter[site_id]=123&sort=title&fields[courses]=title,thumbnail_url",
            "next": "https://api.kajabi.com/v1/courses?page[number]=2&page[size]=10&filter[site_id]=123&sort=title&fields[courses]=title,thumbnail_url",
            "last": "https://api.kajabi.com/v1/courses?page[number]=3&page[size]=10&filter[site_id]=123&sort=title&fields[courses]=title,thumbnail_url"
          },
          "meta": {
            "total_pages": 3,
            "total_count": 25,
            "current_page": 1
          }
        }

        ```
      parameters:
        - name: sort
          in: query
          required: false
          description: >-
            Sort order, use: title, for descending order use '-' e.g.
            &sort=-title
          schema:
            type: string
        - name: page[number]
          in: query
          required: false
          schema:
            type: number
        - name: page[size]
          in: query
          required: false
          description: Number of documents
          schema:
            type: number
        - name: fields[courses]
          in: query
          required: false
          description: >-
            Partial attributes as specified, e.g.
            fields[courses]=title,thumbnail_url
          schema:
            type: string
        - name: filter[site_id]
          in: query
          required: false
          description: Filter by site_id, for example ?filter[site_id]=111
          schema:
            type: string
        - name: filter[title_cont]
          in: query
          required: false
          description: Filter by title contains, for example ?filter[title_cont]=marketing
          schema:
            type: string
        - name: filter[description_cont]
          in: query
          required: false
          description: >-
            Filter by description contains, for example
            ?filter[description_cont]=marketing
          schema:
            type: string
        - name: filter[publish_status_eq]
          in: query
          required: false
          description: >-
            Filter by publish status, for example
            ?filter[publish_status_eq]=published
          schema:
            type: string
      responses:
        '200':
          description: Success, list of courses which the current user may access
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/courses_index_response'
        '401':
          description: Unauthorized, Authorization header is missing or invalid
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/errors_unauthorized'
        '403':
          description: Forbidden, insufficient permission to access the resource
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/errors_forbidden'
      security:
        - Bearer: []
components:
  schemas:
    courses_index_response:
      type: object
      properties:
        data:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              type:
                type: string
              attributes:
                $ref: '#/components/schemas/courses_attributes'
              relationships:
                type: object
                properties:
                  site:
                    type: object
                    properties:
                      data:
                        $ref: '#/components/schemas/resource_identifier'
        links:
          type: object
          properties:
            self:
              type: string
            current:
              type: string
    errors_unauthorized:
      type: object
      properties:
        errors:
          type: array
          items:
            $ref: '#/components/schemas/errors_attributes'
    errors_forbidden:
      type: object
      properties:
        errors:
          type: array
          items:
            $ref: '#/components/schemas/errors_attributes'
    courses_attributes:
      type: object
      properties:
        created_at:
          type: string
          format: date-time
          readOnly: true
          description: ISO 8601 date-time, read only
        title:
          type: string
        description:
          type:
            - string
            - 'null'
        thumbnail_url:
          type:
            - string
            - 'null'
      required:
        - title
    resource_identifier:
      type: object
      properties:
        id:
          type: string
        type:
          type: string
      required:
        - id
        - type
    errors_attributes:
      type: object
      properties:
        status:
          type: string
        source:
          type: object
          nullable: true
          properties:
            pointer:
              type: string
        title:
          type: string
        detail:
          type: string
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer

````