--- title: "Get all teams" method: GET path: "/api/v2/team" tags: ["Teams"] --- # Get all teams `GET /api/v2/team` ## Request - Base URL: `https://api.datadoghq.com` - URL: `https://api.datadoghq.com/api/v2/team` - Auth: one of: - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY` - OAuth 2 - Authorization code: `/oauth2/v1/authorize` - Token URL: `/oauth2/v1/token` scopes: `teams_read` Get all teams. Can be used to search for teams using the `filter[keyword]` and `filter[me]` query parameters. ## Query parameters - `page[number]` integer - `page[size]` integer - `sort` 'name' | '-name' | 'user_count' | '-user_count': Specifies the order of the returned teams - `include` ListTeamsInclude[] - `filter[keyword]` string - `filter[me]` boolean - `fields[team]` TeamsField[] ## Response `200` OK - TeamsResponse: Response with multiple teams - `data` Team[]: Teams response data - `attributes` TeamAttributes, required: Team attributes - `avatar` string, nullable: Unicode representation of the avatar for the team, limited to a single grapheme - `banner` integer, nullable: Banner selection for the team - `created_at` string, date-time: Creation date of the team - `description` string, nullable: Free-form markdown description/content for the team's homepage - `handle` string, required: The team's identifier - `hidden_modules` string[], nullable: Collection of hidden modules for the team - `is_managed` boolean: Whether the team is managed from an external source - `link_count` integer: The number of links belonging to the team - `modified_at` string, date-time: Modification date of the team - `name` string, required: The name of the team - `summary` string, nullable: A brief summary of the team, derived from the `description` - `user_count` integer: The number of users belonging to the team - `visible_modules` string[], nullable: Collection of visible modules for the team - `id` string, required: The team's identifier - `relationships` TeamRelationships: Resources related to a team - `team_links` RelationshipToTeamLinks: Relationship between a team and a team link - `data` RelationshipToTeamLinkData[]: Related team links - `id` string, required: The team link's identifier - `type` 'team_links', required: Team link type - `links` TeamRelationshipsLinks: Links attributes. - `related` string: Related link. - `user_team_permissions` RelationshipToUserTeamPermission: Relationship between a user team permission and a team - `data` RelationshipToUserTeamPermissionData, nullable: Related user team permission data - `id` string, required: The ID of the user team permission - `type` 'user_team_permissions', required: User team permission type - `links` TeamRelationshipsLinks: Links attributes. - `related` string: Related link. - `type` 'team', required: Team type - `included` TeamIncluded[]: Resources related to the team - union: Included resources related to the team - User: User object returned by the API. - `attributes` UserAttributes: Attributes of user object returned by the API. - `created_at` string, date-time: The ISO 8601 timestamp of when the user account was created. - `disabled` boolean: Whether the user account is deactivated. Disabled users cannot log in. - `email` string: The email address of the user, used for login and notifications. - `handle` string: The unique handle (username) of the user, typically matching their email prefix. - `icon` string: URL of the user's profile icon, typically a Gravatar URL derived from the email address. - `last_login_time` string, date-time, nullable: The ISO 8601 timestamp of the user's most recent login, or null if the user has never logged in. - `mfa_enabled` boolean: Whether multi-factor authentication (MFA) is enabled for the user's account. - `modified_at` string, date-time: The ISO 8601 timestamp of when the user account was last modified. - `name` string, nullable: The full display name of the user as shown in the Datadog UI. - `service_account` boolean: Whether this is a service account rather than a human user. Service accounts are used for programmatic API access. - `status` string: The current status of the user account (for example, `Active`, `Pending`, or `Disabled`). - `title` string, nullable: The job title of the user (for example, "Senior Engineer" or "Product Manager"). - `uuid` string: The globally unique identifier (UUID) of the user. - `verified` boolean: Whether the user's email address has been verified. - `id` string: ID of the user. - `relationships` UserResponseRelationships: Relationships of the user object returned by the API. - `org` RelationshipToOrganization: Relationship to an organization. - `data` RelationshipToOrganizationData, required: Relationship to organization object. - … - `other_orgs` RelationshipToOrganizations: Relationship to organizations. - `data` RelationshipToOrganizationData[], required: Relationships to organization objects. - … - `other_users` RelationshipToUsers: Relationship to users. - `data` RelationshipToUserData[], required: Relationships to user objects. - … - `roles` RelationshipToRoles: Relationship to roles. - `data` RelationshipToRoleData[]: An array containing type and the unique identifier of a role. - … - `type` 'users': Users resource type. - TeamLink: Team link - `attributes` TeamLinkAttributes, required: Team link attributes - `label` string, required: The link's label - `position` integer: The link's position, used to sort links for the team - `team_id` string: ID of the team the link is associated with - `url` string, required: The URL for the link - `id` string, required: The team link's identifier - `type` 'team_links', required: Team link type - UserTeamPermission: A user's permissions for a given team - `attributes` UserTeamPermissionAttributes: User team permission attributes - `permissions` object: Object of team permission actions and boolean values that a logged in user can perform on this team. - `id` string, required: The user team permission's identifier - `type` 'user_team_permissions', required: User team permission type - `links` TeamsResponseLinks: Teams response links. - `first` string: First link. - `last` string, nullable: Last link. - `next` string: Next link. - `prev` string, nullable: Previous link. - `self` string: Current link. - `meta` TeamsResponseMeta: Teams response metadata. - `pagination` TeamsResponseMetaPagination: Teams response metadata. - `first_offset` integer: The first offset. - `last_offset` integer: The last offset. - `limit` integer: Pagination limit. - `next_offset` integer: The next offset. - `offset` integer: The offset. - `prev_offset` integer: The previous offset. - `total` integer: Total results. - `type` string: Offset type. ## Other responses - `403`: Forbidden - `429`: Too many requests --- [API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)