---
title: "List team projects"
method: GET
path: "/v1/analytics/team-projects"
tags: ["Analytics"]
---

# List team projects

`GET /v1/analytics/team-projects`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/analytics/team-projects`
- Auth: API key in header `x-magnific-api-key`

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.

## Response `200`

OK

- V1AnalyticsTeamProjectsGet200Response
  - `data` TeamProject[]
    - `project_reference` string, uuid: Project reference UUID. Use in `project_references` filter of team-credit-usage.
    - `name` string: Project name.

## Other responses

- `403`: Forbidden - The client does not have permission to access the requested resource.
- `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle.

---

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