---
title: "Get courses"
method: GET
path: "/training/courses/v1"
tags: ["Training"]
---

# Get courses

`GET /training/courses/v1`

## Request

- Base URL: `https://api.mitti.com`
- URL: `https://api.mitti.com/training/courses/v1`
- Auth: HTTP bearer

Retrieves all courses in your organization.

## Query parameters

- `pageSize` integer
- `page` integer
- `modifiedSince` string, date-time
- `publicationStatus` 'PUBLICATION_STATUS_UNKNOWN' | 'PUBLICATION_STATUS_PUBLISHED'
- `courseIds` string[]
- `locale` string
- `searchTerm` string
- `groupIds` string[]
- `siteIds` string[]
- `userId` string

## Response `200`

A successful response.

- S12TrainingCoursesV1GetCoursesResponse
  - `totalCount` integer: The total number of courses matching the request
  - `items` S12TrainingCoursesV1Course[]: List of courses
    - `id` string: ID of the course
    - `externalId` string: External ID of the course
    - `title` string: Title of the course
    - `description` string: Description of the course
    - `status` string: Status of the course (Draft, Scheduled, Published, Archived)
    - `locale` string: Locale of the course
    - `isMandatory` boolean: Flag to indicate if the course is mandatory to take for users
    - `dueBy` string: Due by type of the course (notSpecified, static, relative)
    - `duration` integer: Duration of the course in seconds
    - `thumbnailUrl` string: URL of the thumbnail image for the course
    - `createdDatetime` string, date-time: Created date of the course
    - `modifiedDatetime` string, date-time: Modified date of the course
    - `translationOriginalCourse` S12TrainingCoursesV1TranslationOriginalCourse
      - `id` string: ID of the original course
      - `externalId` string: External ID of the original course
    - `logoUrl` string: Logo URL of the course
    - `brandingImageUrl` string: Branding image URL of the course
    - `isPublished` boolean: Flag indicating if the course is published
    - `lessonCount` integer: Number of lessons in the course
    - `publishedDatetime` string, date-time: Date and time the latest published version was published. Unset if the course has never been published.
    - `publishedVersionNumber` integer: The latest published version number that published_datetime belongs to. 0 if the course has never been published.
    - `isRecurring` boolean: Flag indicating if the course has Recurring certification enabled

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-11-03** `eb6bb843bf18`: 3 info
  - added the optional property `items/items/isRecurring` to the response with the `200` status
  - added the optional property `items/items/publishedDatetime` to the response with the `200` status
  - added the optional property `items/items/publishedVersionNumber` to the response with the `200` status

[Operation history](https://skmtc.dev/safetyculture/apis/safetyculture-api/changes/training/courses/v1/get.md)

---

[API](https://skmtc.dev/safetyculture/apis/safetyculture-api.md) - [All operations](https://skmtc.dev/safetyculture/apis/safetyculture-api/llms.txt) - [OpenAPI document](https://skmtc.dev/safetyculture/apis/safetyculture-api/revisions/eb6bb843bf18?raw)
