---
title: "Return One Team by ID"
method: GET
path: "/api/atlas/v2/orgs/{orgId}/teams/{teamId}"
tags: ["Teams"]
---

# Return One Team by ID

`GET /api/atlas/v2/orgs/{orgId}/teams/{teamId}`

Returns one team that you identified using its unique 24-hexadecimal digit ID. This team belongs to one organization. Teams enable you to grant project access roles to MongoDB Cloud users.

## Path parameters

- `orgId` string, required
- `teamId` string, required

## Query parameters

- `envelope` boolean
- `pretty` boolean

## Response `200`

OK

## Other responses

- `400` — Bad Request.
- `401` — Unauthorized.
- `403` — Forbidden.
- `404` — Not Found.
- `429` — Too Many Requests.
- `500` — Internal Server Error.

---

[API](https://skmtc.dev/mongodb/apis/atlas-admin-api.md) · [All operations](https://skmtc.dev/mongodb/apis/atlas-admin-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mongodb/apis/atlas-admin-api/revisions/e37e8ef8429f?raw)