--- title: "Get all teams" method: GET path: "/api/v2/team" tags: ["Teams"] --- # Get all teams `GET /api/v2/team` 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.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/versions/da68bf029e4c/schema)