---
title: "Get projects in a team"
method: GET
path: "/v1/teams/{team_id}/projects"
tags: ["Projects"]
---

# Get projects in a team

`GET /v1/teams/{team_id}/projects`

You can use this endpoint to get a list of all the Projects within the specified team. This will only return projects visible to the authenticated user or owner of the developer token. Note: it is not currently possible to programmatically obtain the team id of a user just from a token. To obtain a team id, navigate to a team page of a team you are a part of. The team id will be present in the URL after the word team and before your team name.

## Path parameters

- `team_id` string, required

## Response `200`

Response from the GET /v1/teams/{team_id}/projects endpoint.

- object
  - `name` string, required — The team's name.
  - `projects` Project[], required — An array of projects.
    - `id` string, required — The ID of the project.
    - `name` string, required — The name of the project.

## Other responses

- `400` — Bad request. Parameters are invalid or malformed. Please check the input formats. This error can also happen if the requested resources are too large to complete the request, which results in a timeout. Please reduce the number and size of objects requested.
- `403` — The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource, or may need an account of some sort.
- `429` — In some cases API requests may be throttled or rate limited. Please wait a while before attempting the request again (typically a minute).
- `500` — An internal server error occurred.

---

[API](https://skmtc.dev/thirdstrandstudio/apis/figma-api.md) · [All operations](https://skmtc.dev/thirdstrandstudio/apis/figma-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thirdstrandstudio/figma-api/revisions/48f84f49653a/schema)