---
title: "Get Team Info"
slug: "get-team-info"
updated: 2026-09-03T14:50:33Z
published: 2026-09-03T14:50:33Z
canonical: "developer.rocket.chat/get-team-info"
stale: true
---

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

# Get Team Info

Get/api/v1/teams.info

Gets a team's information. If the team is not public, the request sender must be a member of the team, or must have the `view-all-teams` permission.

Header parametersX-Auth-TokenstringRequired

The `authToken` of the authenticated user.

ExampleRScctEHSmLGZGywfIhWyRpyofhKOiMoUIpimhvheU3f
X-User-IdstringRequired

The `userId` of the authenticated user.

ExamplerbAXPnMktTFbNpwtJ

Query parametersteamIdstring

The team id. It is required if the `teamName` is not provided.

Example63f3efc4b000b6b6d86704b2
teamNamestring

The team name. It is required if the `teamId` is not provided.

Examplelivestream

Responses200

OK

Note that the `roomId` is main room id of the team.

<select class='api-response-data' aria-label='Media type'><option value='35d01dab-86cb-44e3-bde9-07a721d55a98'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='49d03ba4-56ed-4129-a1fd-63cb1fd37fdc'>Success</option>
</select>Success

```json
{
  "teamInfo": {
    "_id": "607e0d9b49d493189836bfac",
    "name": "Team1",
    "type": 1,
    "createdAt": "2021-04-19T23:09:15.106Z",
    "createdBy": {
      "_id": "FL2fZL4ERhwA3gWiS",
      "username": "some.username"
    },
    "_updatedAt": "2021-04-19T23:09:15.106Z",
    "roomId": "Dgh2xwJ3NFKWvKSqY"
  },
  "success": true
}
```

Expand Allobject  teamInfoobject  _idstring    
namestring    
typeinteger    
createdAtstring    
createdByobject  _idstring    
usernamestring    

_updatedAtstring    
roomIdstring    

successboolean    

401

Unauthorized

<select class='api-response-data' aria-label='Media type'><option value='01fa32ee-6756-4bd8-9885-12efb3665654'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='0ec46bcb-93c3-45ca-a95b-4dd8fd0a6b1e'>Authorization Error</option>
</select>Authorization Error

```json
{
  "status": "error",
  "message": "You must be logged in to do this."
}
```

object  statusstring    
messagestring