# List all teams

Returns all teams in your organization.

### Response Structure

The response includes:
- object - Always "list"
- data - Array of team objects

### Team Object

Each team includes:
- id - Unique team identifier
- name - Team display name
- color - Team color in hex format
- icon - Team icon (emoji, predefined, or external URL)
- members - Array of admin IDs who are members of this team

### Example Response

json
{
  "object": "list",
  "data": [
    {
      "object": "team",
      "id": "507f1f77bcf86cd799439011",
      "name": "Support Team",
      "color": "#3B82F6",
      "icon": {
        "value": "👥",
        "type": "emoji"
      },
      "members": ["5fef50c5e9458a0012f82456", "5fef50c5e9458a0012f82457"]
    }
  ]
}


### Version Availability

This endpoint is only available in API version 2026-01-01.nova and newer.

Endpoint: GET /v2/teams
Version: 2026-01-01.nova
Security: bearerAuth

## Header parameters:

  - `Featurebase-Version` (string)
    API version for this request. Defaults to your organization's configured API version if not specified.
    Example: "2026-01-01.nova"

## Response 200 fields (application/json):

  - `object` (string, required)
    Object type identifier
    Enum: "list"

  - `data` (array, required)
    Array of teams
    Example: []

  - `data.id` (string, required)
    Unique identifier
    Example: "507f1f77bcf86cd799439011"

  - `data.name` (string, required)
    Team name
    Example: "Support Team"

  - `data.color` (string, required)
    Team color in hex format
    Example: "#3B82F6"

  - `data.icon` (object,null, required)
    Team icon

  - `data.icon.value` (string, required)
    Icon value
    Example: "👥"

  - `data.icon.type` (string, required)
    Type of icon
    Enum: "emoji", "predefined", "external"

  - `data.members` (array, required)
    Array of admin IDs who are members of this team
    Example: ["5fef50c5e9458a0012f82456","5fef50c5e9458a0012f82457"]

## Response 400 fields (application/json):

  - `error` (object, required)

  - `error.type` (string, required)
    The type of error returned
    Enum: "invalid_request_error"

  - `error.code` (string, required)
    Machine-readable error code
    Enum: "invalid_id", "invalid_parameter", "missing_parameter", "invalid_cursor", "invalid_content", "invalid_request", "contact_not_customer", "contact_not_attached", "parameter_not_supported"

  - `error.message` (string, required)
    Example: "Invalid post ID format"

  - `error.param` (string)
    Example: "id"

  - `error.status` (number, required)
    HTTP status code
    Enum: 400

  - `error.details` (array)
    Additional validation error details

  - `error.details.path` (string, required)
    Example: "body.name"

## Response 404 fields (application/json):

  - `error` (object, required)

  - `error.type` (string, required)
    The type of error returned
    Enum: "invalid_request_error"

  - `error.code` (string, required)
    Machine-readable error code
    Enum: "resource_not_found", "post_not_found", "comment_not_found", "changelog_not_found", "admin_not_found", "contact_not_found", "conversation_not_found", "conversation_part_not_found", "team_not_found", "survey_not_found", "company_not_found", "help_center_not_found", "collection_not_found", "article_not_found", "custom_field_not_found", "board_not_found", "voter_not_found", "participant_not_found", "webhook_not_found", "version_not_supported"

  - `error.message` (string, required)
    Example: "Post not found"

  - `error.status` (number, required)
    HTTP status code
    Enum: 404

## Response 500 fields (application/json):

  - `error` (object, required)

  - `error.type` (string, required)
    The type of error returned
    Enum: "api_error"

  - `error.code` (string, required)
    Machine-readable error code
    Enum: "database_error", "internal_error", "fetch_error", "create_error", "update_error", "delete_error"

  - `error.message` (string, required)
    Example: "An internal error occurred"

  - `error.status` (number, required)
    HTTP status code
    Enum: 500