Get a team

GET

/teams/:teamId

Gets information about a Postman team.

Authentication

x-api-keystring

API Key authentication via header

Authorizationstring

A valid SCIM API key for calls to SCIM endpoints.

A valid [SCIM API key](https://learning.postman.com/docs/administration/scim-provisioning/scim-provisioning-overview/#generating-scim-api-key) for calls to SCIM endpoints.

AuthorizationBasic

Basic authentication of the form Basic <base64(username:password)>.

Path parameters

teamIdintegerRequired

The team's ID.

Query parameters

includeenumOptional

Include additional information in the request’s response:

members — Include all users and groups, including groups that represent other teams or the entire organization, with access to the team’s entities. This includes team managers, members, and persons invited to collaborate as guests.
userRoles — Include all the team’s user roles in the response.

Include additional information in the request's response: - `members` — Include all users and groups, including groups that represent other teams or the entire organization, with access to the team's entities. This includes team managers, members, and persons invited to collaborate as guests. - `userRoles` — Include all the team's user roles in the response.

Allowed values:

Response

Successful Response

teamobject

Information about the team.

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error

1	{
2	"team": {
3	"createdAt": "2025-02-26T08:17:42.000Z",
4	"updatedAt": "2025-02-26T08:17:42.000Z",
5	"id": 123,
6	"name": "Testing Team",
7	"handle": "testing-team",
8	"description": "API testing team.",
9	"organizationId": 1,
10	"createdBy": 12345678,
11	"enabled": true
12	}
13	}