# Get team by ID

Retrieves a single team by its Featurebase ID.

### Path Parameters

- id - The Featurebase internal ID of the team (MongoDB ObjectId)

### Response

Returns a team object with:
- 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": "team",
  "id": "507f1f77bcf86cd799439011",
  "name": "Support Team",
  "color": "#3B82F6",
  "icon": {
    "value": "👥",
    "type": "emoji"
  },
  "members": ["5fef50c5e9458a0012f82456", "5fef50c5e9458a0012f82457"]
}


### Error Responses

- 404 Not Found - Team with the specified ID does not exist

### Version Availability

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

Endpoint: GET /v2/teams/{id}
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"

## Path parameters:

  - `id` (string, required)
    The Featurebase internal ID of the team (MongoDB ObjectId)
    Example: "507f1f77bcf86cd799439011"

## Response 200 fields (application/json):

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

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

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

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

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

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

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

  - `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"

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

  - `error.param` (string)
    The parameter that caused the error (if applicable)
    Example: "id"

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

## 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: "team_not_found"

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

  - `error.param` (string)
    The parameter that caused the error (if applicable)
    Example: "id"

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