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

# Get courses

`GET /training/courses/v1`

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

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/safetyculture/apis/safetyculture-api.md) · [All operations](https://skmtc.net/safetyculture/apis/safetyculture-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/safetyculture/safetyculture-api/revisions/5be91df61ded/schema)