---
title: "Retrieve an external course"
method: GET
path: "/api/v2/integrations/{integrationId}/courses/{externalId}"
tags: ["Integrations"]
---

# Retrieve an external course

`GET /api/v2/integrations/{integrationId}/courses/{externalId}`

> 🔑
>
> Required OAuth scope: `integrations:read`.

Retrieves the details of a specific course with the provided external platform course ID.

## Path parameters

- `integrationId` string, ObjectId, required
- `externalId` string, required

## Headers

- `360-api-version` 'v2.0', required

## Response `200`

Returns the details of the given external course.

- ExternalCourseResponseDTO
  - `defaultLang` 'bg' | 'cs' | 'da' | 'de' | 'el' | 'en' | 'es' | 'fi' | 'fr' | 'hr' | 'ht_HT' | 'hu' | 'id' | 'it' | 'ja' | 'kar_MM' | 'ko' | 'lt' | 'mh_MH' | 'nl' | 'nl_BE' | 'no' | 'pl' | 'pt' | 'ro' | 'ru' | 'rw_RW' | 'sk' | 'sl' | 'so_SO' | 'sv' | 'sw_KE' | 'th' | 'ti_ET' | 'tr' | 'uk' | 'zh' | 'am_ET' | 'bn' | 'bs' | 'ca' | 'cy' | 'en_CA' | 'en_GB' | 'es_AR' | 'es_MX' | 'et' | 'fr_CA' | 'gu' | 'he_IL' | 'hy' | 'kk' | 'km' | 'lo' | 'lv' | 'mi' | 'mn_MN' | 'mr' | 'ms' | 'my_MM' | 'nn_NO' | 'or' | 'pa' | 'pt_BR' | 'pt_MZ' | 'rn_BI' | 'si' | 'ta' | 'te' | 'tl_PH' | 'ur' | 'uz' | 'yo_NG' | 'zh_tw' | 'el' | 'hi' | 'sr' | 'ar' | 'vi' | 'zh_HANT', required — The language of the external course which is displayed by default when the learner’s profile language is not available. The `name`, `description`, `subjects`, `launchUrl`, and `mobileLaunchUrl` values must be coherent with this language.
  - `externalId` string, required — The unique external ID of the external course.
  - `launchUrl` string, required — The URL to launch and play the external course.
  - `name` string, required — The title of the external course.
  - `sources` ExternalCourseSourceDTO[], required — The list of sources of the external course.
    - `name` string, required — The name of the source.
    - `logoUrl` string — The logo URL of the source.
  - `subjects` string[], required — The list of subjects of the external course.
  - `contentType` 'article' | 'assessment' | 'audiobook' | 'book' | 'certificate' | 'channel' | 'course' | 'curriculum' | 'interactive' | 'journey' | 'labs' | 'linkedContent' | 'mooc' | 'podcast' | 'program' | 'roleplay' | 'specialization' | 'topvoice' | 'video' — The type of the external course. If not set, `course` type is used.
  - `description` string — The description of the external course.
  - `difficultyLevel` 'advanced' | 'beginner' | 'intermediate' — The level of difficulty of the external course.
  - `duration` integer — The duration of the external course, in minutes.
  - `imageUrl` string — The URL of the image of the external course.
  - `mobileLaunchUrl` string — The URL to launch and play the external course from a mobile. If not set, the `launchUrl` is used.
  - `authorId` string, ObjectId, required — The unique ID of the author.
  - `courseId` string, ObjectId, required — The unique ID of the course created from this external course.
  - `translations` ExternalCourseTranslationDTO[], required — The different translations available for the external course.
    - `lang` 'bg' | 'cs' | 'da' | 'de' | 'el' | 'en' | 'es' | 'fi' | 'fr' | 'hr' | 'ht_HT' | 'hu' | 'id' | 'it' | 'ja' | 'kar_MM' | 'ko' | 'lt' | 'mh_MH' | 'nl' | 'nl_BE' | 'no' | 'pl' | 'pt' | 'ro' | 'ru' | 'rw_RW' | 'sk' | 'sl' | 'so_SO' | 'sv' | 'sw_KE' | 'th' | 'ti_ET' | 'tr' | 'uk' | 'zh' | 'am_ET' | 'bn' | 'bs' | 'ca' | 'cy' | 'en_CA' | 'en_GB' | 'es_AR' | 'es_MX' | 'et' | 'fr_CA' | 'gu' | 'he_IL' | 'hy' | 'kk' | 'km' | 'lo' | 'lv' | 'mi' | 'mn_MN' | 'mr' | 'ms' | 'my_MM' | 'nn_NO' | 'or' | 'pa' | 'pt_BR' | 'pt_MZ' | 'rn_BI' | 'si' | 'ta' | 'te' | 'tl_PH' | 'ur' | 'uz' | 'yo_NG' | 'zh_tw' | 'el' | 'hi' | 'sr' | 'ar' | 'vi' | 'zh_HANT', required — The language of the translation.
    - `translatedFields` ExternalCourseTranslatedFields, required
      - `description` string — The translation of the field `description` for this language.
      - `launchUrl` string — The URL to launch and play the external course in this language.
      - `mobileLaunchUrl` string — The URL to launch and play the external course from a mobile in this language.
      - `name` string — The translation of the field `name` for this language.
      - `subjects` string[] — The translation of the field `subjects` for this language.

## Other responses

- `400` — The given `externalId` does not belong to the given integration.
- `401` — The given access token is either missing, invalid, has expired, or has been revoked.
- `403` — The given access token does not have the required OAuth scope to execute the request.
- `404` — The given `integrationId` does not correspond to any existing integration.
- `429` — The client has sent too many requests in a short amount of time.

---

[API](https://skmtc.dev/360learning/apis/core-api.md) · [All operations](https://skmtc.dev/360learning/apis/core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/360learning/core-api/revisions/94b691b0b72c/schema)