> ## Documentation Index
> Fetch the complete documentation index at: https://docs.magnific.com/llms.txt
> Use this file to discover all available pages before exploring further.

> List all groups in your team with their name and member count. Use group IDs to filter credit usage reports.

# List team groups



## OpenAPI

````yaml get /v1/analytics/team-groups
openapi: 3.0.0
info:
  description: >-
    The Magnific API is your gateway to a vast collection of high-quality
    digital resources for your applications and projects. As a leading platform,
    it offers a wide range of graphics, including vectors, photos,
    illustrations, icons, PSD templates, and more, all curated by talented
    designers from around the world.
  title: Magnific API
  version: 1.0.0
servers:
  - description: B2B API Production V1
    url: https://api.magnific.com
security:
  - magnificApiKey: []
paths:
  /v1/analytics/team-groups:
    get:
      tags:
        - Analytics
      summary: List team groups
      description: >
        Returns all groups within the caller's team with their ID, name,

        and member count. Use the returned `group_id` values as filters in

        `POST /v1/analytics/team-credit-usage`.


        Authenticates via API key (`X-Magnific-API-Key` header). The caller's
        team

        is resolved automatically from the API key.
      responses:
        '200':
          content:
            application/json:
              examples:
                success:
                  $ref: '#/components/examples/200-analytics-team-groups'
              schema:
                $ref: >-
                  #/components/schemas/_v1_analytics_team_groups_get_200_response
          description: OK
        '403':
          content:
            application/json:
              examples:
                user_not_authorized:
                  summary: User has not privileges to access some resource
                  value:
                    message: User is not authorized to access this resource
                user_not_owner:
                  summary: Collection author id is different from current user's id
                  value:
                    message: User is not owner of requested collection
                item_is_premium:
                  summary: The user cannot download this item because it is premium
                  value:
                    message: The user cannot download this item because it is premium
                creator_not_authorized:
                  summary: Creator has not privileges to access some resource
                  value:
                    message: Creator is not authorized to access this resource
              schema:
                $ref: '#/components/schemas/get_all_style_transfer_tasks_400_response'
          description: >-
            Forbidden - The client does not have permission to access the
            requested resource.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/get_all_style_transfer_tasks_500_response'
          description: >-
            Internal Server Error - The server has encountered a situation it
            doesn't know how to handle.
components:
  examples:
    200-analytics-team-groups:
      summary: Success - List of team groups.
      value:
        data:
          - group_id: 10
            name: Design Team
            member_count: 5
          - group_id: 20
            name: Marketing Team
            member_count: 8
          - group_id: 30
            name: Engineering
            member_count: 12
  schemas:
    _v1_analytics_team_groups_get_200_response:
      example:
        data:
          - group_id: 10
            name: Design Team
            member_count: 5
          - group_id: 10
            name: Design Team
            member_count: 5
      properties:
        data:
          items:
            $ref: '#/components/schemas/team-group'
          type: array
      type: object
    get_all_style_transfer_tasks_400_response:
      example:
        message: message
      properties:
        message:
          type: string
      type: object
    get_all_style_transfer_tasks_500_response:
      example:
        message: Internal Server Error
      properties:
        message:
          example: Internal Server Error
          type: string
      type: object
    team-group:
      example:
        group_id: 10
        name: Design Team
        member_count: 5
      properties:
        group_id:
          description: Group identifier. Use in `group_ids` filter of team-credit-usage.
          example: 10
          type: integer
        name:
          description: Group name.
          example: Design Team
          type: string
        member_count:
          description: Number of members in this group.
          example: 5
          type: integer
      type: object
  securitySchemes:
    magnificApiKey:
      description: >
        Your Magnific API key. Required for authentication. [Learn how to obtain
        an API key](https://docs.magnific.com/quickstart)
      in: header
      name: x-magnific-api-key
      type: apiKey

````