---
title: "Get a group type and its roles. Roles: public."
method: GET
path: "/api/groupTypes/{groupTypeId}"
tags: ["Group Types"]
---

# Get a group type and its roles. Roles: public.

`GET /api/groupTypes/{groupTypeId}`

## 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/groupTypes/{groupTypeId}`
- Auth: none declared

## Path parameters

- `groupTypeId` integer, required

## Response `200`

OK

- GroupTypeResponseGroupTypeFull
  - `success` boolean
  - `error` string
  - `groupType` GroupTypeFull
    - `audit` Audit
      - `createdTime` string, date-time
      - `modifiedTime` string, date-time
      - `modifiedBy` string
    - `groupTypeId` integer
    - `membershipId` integer
    - `name` string
    - `namePlural` string
    - `description` string
    - `properties` GroupTypeProperties
      - `announcementsHtml` string
      - `chatEnabled` boolean
      - `chatDefaultEnabled` boolean
      - `contactSharingDefaultEnabled` boolean
      - `postsEnabled` boolean
      - `postsDefaultEnabled` boolean
    - `root` boolean
    - `external` boolean
    - `externalReferenceId` string
    - `isPrivate` boolean
    - `groupRoles` GroupRoleCore[]
      - `audit` Audit
        - `createdTime` string, date-time
        - `modifiedTime` string, date-time
        - `modifiedBy` string
      - `groupRoleId` integer
      - `name` string
      - `namePlural` string
      - `external` boolean
      - `externalReferenceId` string
      - `selfRegistrationAccessCode` 'CLOSED' | 'GROUP_MEMBERS' | 'OPEN'
      - `dependentRegistrationAccessCode` 'CLOSED' | 'GROUP_MEMBERS' | 'OPEN'
      - `invitationsAllowed` boolean
      - `activitySubmissionNotificationsEnabled` boolean
      - `permissions` string[]
    - `parentGroupType` GroupTypeCore
      - `audit` Audit
        - `createdTime` string, date-time
        - `modifiedTime` string, date-time
        - `modifiedBy` string
      - `groupTypeId` integer
      - `membershipId` integer
      - `name` string
      - `namePlural` string
      - `description` string
      - `properties` GroupTypeProperties
        - `announcementsHtml` string
        - `chatEnabled` boolean
        - `chatDefaultEnabled` boolean
        - `contactSharingDefaultEnabled` boolean
        - `postsEnabled` boolean
        - `postsDefaultEnabled` boolean
      - `root` boolean
      - `external` boolean
      - `externalReferenceId` string
      - `isPrivate` boolean
    - `childGroupTypes` GroupTypeCore[]
      - `audit` Audit
        - `createdTime` string, date-time
        - `modifiedTime` string, date-time
        - `modifiedBy` string
      - `groupTypeId` integer
      - `membershipId` integer
      - `name` string
      - `namePlural` string
      - `description` string
      - `properties` GroupTypeProperties
        - `announcementsHtml` string
        - `chatEnabled` boolean
        - `chatDefaultEnabled` boolean
        - `contactSharingDefaultEnabled` boolean
        - `postsEnabled` boolean
        - `postsDefaultEnabled` boolean
      - `root` boolean
      - `external` boolean
      - `externalReferenceId` string
      - `isPrivate` boolean

## Other responses

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

## Changes

- **2026-10-29** `df463b248fcb`: 2 warning, 1 info
  - added the new `VIEW_COURSES` enum value to the `groupType/groupRoles/items/permissions/items/` response property for the response status `200`
  - added the new `VIEW_PROGRAMS` enum value to the `groupType/groupRoles/items/permissions/items/` response property for the response status `200`
  - removed the `VIEW_EDUCATION` enum value from the `groupType/groupRoles/items/permissions/items/` response property for the response status `200`
- **2026-09-18** `36f72442f0a1`: 4 info
  - added the optional property `groupType/childGroupTypes/items/externalReferenceId` to the response with the `200` status
  - added the optional property `groupType/externalReferenceId` to the response with the `200` status
  - added the optional property `groupType/groupRoles/items/externalReferenceId` to the response with the `200` status
  - added the optional property `groupType/parentGroupType/externalReferenceId` to the response with the `200` status
- **2026-09-02** `870f28ba2607`: 5 info
  - added the optional property `error/errorId` to the response with the `400` status
  - added the optional property `error/errorId` to the response with the `401` status
  - added the optional property `error/errorId` to the response with the `403` status
  - added the optional property `error/errorId` to the response with the `404` status
  - …1 more

[Operation history](https://skmtc.dev/mobilecoach/apis/mobilecoach-api/changes/api/groupTypes/:groupTypeId/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/df463b248fcb?raw)