---
title: "Get usage information for a course. Roles: admin."
method: GET
path: "/api/courses/{contentId}/usage"
tags: ["Courses"]
---

# Get usage information for a course. Roles: admin.

`GET /api/courses/{contentId}/usage`

## Request

- Base URL: `https://api.mobilecoach.org` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mobilecoach.org/api/courses/{contentId}/usage`
- Auth: none declared
- TypeScript: <https://skmtc.dev/mobilecoach/apis/mobilecoach-api/docs/api/courses/:contentId/usage/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `contentId` integer, required

## Response `200`

OK

- ContentUsageResponse
  - `success` boolean
  - `error` string
  - `usage` ContentUsage
    - `pages` PageCore[]
      - `audit` Audit
        - `createdTime` string, date-time
        - `modifiedTime` string, date-time
        - `modifiedBy` string
      - `alternateLocales` object
        - `empty` boolean
      - `pageId` integer
      - `membershipId` integer
      - `token` string
      - `typeCode` 'BLOCK' | 'BOOK' | 'PAGE' | 'SPLASH'
      - `sharedMembershipId` integer
      - `sharedPageId` integer
      - `title` string
      - `subTitle` string
      - `shortTitle` string
      - `detail` string
      - `body` string
      - `slug` string
      - `publishStartDate` string, date
      - `publishEndDate` string, date
      - `external` boolean
      - `previewing` boolean
      - `defaultViewType` string
      - `defaultSort` 'ALPHABETICAL' | 'REVERSE_CHRONOLOGICAL' | 'PRIORITY'
      - `parentPageId` integer
      - `priority` integer
      - `coverImageUuid` string, uuid
      - `thumbnailImageUuid` string, uuid
      - `coverVideoUrl` string
      - `externalPluginId` integer
      - `externalId` string
      - `sponsorId` integer
      - `audienceId` integer
      - `audiencePromo` AudiencePromo
        - `contentId` integer
        - `actionText` string
        - `localizedValues` AudiencePromoLocaleValues
          - `actionText` string
      - `splashDisplayMax` integer
      - `externalCssUrl` string
      - `locale` string
      - `isPublished` boolean
      - `isPrivate` boolean

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `500`: Internal server error

## Changes

- **2026-11-10** `b27d71336bb6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/mobilecoach/apis/mobilecoach-api/changes/api/courses/:contentId/usage/get.md)

---

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