> ## 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 projects in your team with their reference UUID and name. Use project references to filter credit usage reports.

# List team projects



## OpenAPI

````yaml get /v1/analytics/team-projects
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-projects:
    get:
      tags:
        - Analytics
      summary: List team projects
      description: >
        Returns all projects within the caller's team with their

        reference UUID and name. Use the returned `project_reference` values

        in the `project_references` filter of `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-projects'
              schema:
                $ref: >-
                  #/components/schemas/_v1_analytics_team_projects_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-projects:
      summary: Success - List of team projects.
      value:
        data:
          - project_reference: a1b2c3d4-1111-4000-8000-000000000001
            name: Marketing Campaign Q4
          - project_reference: b2c3d4e5-2222-4000-8000-000000000002
            name: Product Launch Assets
          - project_reference: c3d4e5f6-3333-4000-8000-000000000003
            name: Social Media Templates
  schemas:
    _v1_analytics_team_projects_get_200_response:
      example:
        data:
          - project_reference: a1b2c3d4-1111-4000-8000-000000000001
            name: Marketing Campaign Q4
          - project_reference: a1b2c3d4-1111-4000-8000-000000000001
            name: Marketing Campaign Q4
      properties:
        data:
          items:
            $ref: '#/components/schemas/team-project'
          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-project:
      example:
        project_reference: a1b2c3d4-1111-4000-8000-000000000001
        name: Marketing Campaign Q4
      properties:
        project_reference:
          description: >-
            Project reference UUID. Use in `project_references` filter of
            team-credit-usage.
          example: a1b2c3d4-1111-4000-8000-000000000001
          format: uuid
          type: string
        name:
          description: Project name.
          example: Marketing Campaign Q4
          type: string
      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

````