# Show single usergroup

Endpoint: GET /user-groups/{id}
Version: v1
Security: http

## Path parameters:

  - `id` (integer, required)

## Query parameters:

  - `findBy` (string)
    The field to search by
    Enum: "id", "external_id"

  - `include` (string)
    Available includes are users. You can include multiple options by separating them with a comma.

## Response 200 fields (application/json):

  - `id` (string, required)

  - `external_id` (string,null, required)
    Can be used to add an identifier to the client from an external system, must be unique

  - `name` (string, required)

  - `is_team` (boolean, required)
    If true, this usergroup is shown as team

  - `users` (array, required)

  - `users.first_name` (string, required)

  - `users.last_name` (string, required)

  - `users.title` (string,null, required)

  - `users.title_suffix` (string,null, required)

  - `users.email` (string, required)

  - `users.birthday` (string,null, required)

  - `users.gender` (string,null, required)

  - `users.position` (string,null, required)

  - `users.special_roles` (string,null, required)

  - `users.skills` (string,null, required)

  - `users.profile` (string,null, required)

  - `users.language` (string,null, required)
    UI language

  - `users.languages` (string,null, required)
    Spoken languages

  - `users.telephone_office` (string,null, required)
    Mobile phone (Office)

  - `users.phone_extension` (string,null, required)
    Landline phone (Office)

  - `users.telephone` (string,null, required)
    Mobile phone (Private)

  - `users.entry_date` (string,null, required)
    Date of joining the company

  - `users.leave_date` (string,null, required)
    Date of leaving the company - if set in the future, the employee will be archived on that date

  - `users.type` (string, required)
    Enum: "user", "guest", "tax_advisor"

  - `users.plan` (string, required)
    Enum: "basic", "standard", "external", "advanced", "expert", "guest", "tax_advisor", "not_assigned"

  - `users.is_owner` (boolean, required)
    Is Kanbert space owner

  - `users.avatar` (any, required)

  - `users.userGroups` (array)

  - `users.userGroupsCount` (integer)

  - `users.userGroupsExists` (boolean)

  - `users.customFields` (object, required)
    The key is the field name for your custom field, value type depends on the field type

  - `users.created_at` (string, required)

  - `users.deleted_at` (string,null, required)

## Response 401 fields (application/json):

  - `message` (string, required)
    Error overview.

## Response 404 fields (application/json):

  - `message` (string, required)
    Error overview.

## Response 422 fields (application/json):

  - `message` (string, required)
    Errors overview.

  - `errors` (object, required)
    A detailed description of each field that failed validation.