# Get subteams

Retrieve subteams with optional filtering and pagination

Endpoint: GET /subteams
Version: 1.1.1
Security: BearerAuth

## Query parameters:

  - `subteam_ids` (array)
    Filter by comma-separated list of subteam IDs
    Example: ["123e4567-e89b-12d3-a456-426614174000"]

  - `account_id` (string)
    Filter by account ID
    Example: "4b88ff32-8ba0-4bbf-8e60-c789909ac176"

  - `limit` (integer)
    Maximum number of items to return per page (default 50, max 100)
    Example: 25

  - `page_number` (integer)
    Page number for pagination (0-indexed, default 0)
    Example: 1

## Response 200 fields (application/json):

  - `id` (string, required)
    Unique identifier for the subteam
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `name` (string, required)
    Name of the subteam
    Example: "Marketing Team"

  - `account_id` (string)
    ID of the account to associate with the subteam
    Example: "cd702dbe-bf32-41cc-83a2-efe00f495f04"

## Response 400 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (array)
    Detailed error information
    Example: [{"keyword":"required","dataPath":"","schemaPath":"#/required","params":{"missingProperty":"account_id"},"message":"should have required property 'account_id'"}]

## Response 401 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (array)
    Detailed error information
    Example: [{"keyword":"required","dataPath":"","schemaPath":"#/required","params":{"missingProperty":"account_id"},"message":"should have required property 'account_id'"}]

## Response 500 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (array)
    Detailed error information
    Example: [{"keyword":"required","dataPath":"","schemaPath":"#/required","params":{"missingProperty":"account_id"},"message":"should have required property 'account_id'"}]