# List team handling segments

Shows the time teammates spent actively working on a conversation, and which team the conversation was assigned to while they did. Each period covers a single team assignment, and never continues across a team change. `team` is `null` for time when no team was assigned. The response doesn't say which teammate did the work.
Moving a conversation to another team usually unassigns the teammate as well. Their period then ends with an `end_reason` of `assignment`, and the next period starts, with a `start_reason` of `null`, when a teammate picks the conversation up again. You'll only see `team_change` when the team changes and the same teammate keeps working without a break, for example when round robin assigns the conversation back to the teammate who already had it.
Periods with no team assigned are returned with `team` set to `null`. `ended_at` is `null` while a period is still open.
Requires the `read_conversations` OAuth scope, and the caller must be able to access the conversation.

Endpoint: GET /conversations/{id}/team_handling_segments
Version: Preview
Security: bearerAuth

## Path parameters:

  - `id` (string, required)
    The identifier for the conversation as given by Intercom.

## Header parameters:

  - `Intercom-Version` (string)

## Response 200 fields (application/json):

  - `team_handling_segments` (array)
    Example: [{"team":{"type":"team","id":"814865","name":"Billing"},"started_at":"2026-09-28T10:10:00Z","ended_at":"2026-09-28T10:20:00Z","start_reason":null,"end_reason":"assignment"}]

  - `team_handling_segments.team` (object, required)
    The team assigned when the period ran, or null if no team was assigned

  - `team_handling_segments.team.type` (string, required)
    Enum: "team"

  - `team_handling_segments.team.id` (string, required)
    Example: 814865

  - `team_handling_segments.team.name` (string, required)
    Example: Billing

  - `team_handling_segments.started_at` (string, required)
    Example: 2026-09-28T10:10:00Z

  - `team_handling_segments.ended_at` (string, required)
    Null while the period is still open
    Example: 2026-09-28T10:20:00Z

  - `team_handling_segments.start_reason` (string)
    team_change when the team changed while the teammate kept handling without a break, otherwise null
    Example: team_change

  - `team_handling_segments.end_reason` (string)
    Why the period ended (switch, assignment, reassign, snooze, close, away, auto_away, session_drop, team_change). Null while the period is still open.
    Example: assignment

## Response 400 fields (application/json):

  - `type` (string, required)
    The type is error.list
    Example: error.list

  - `request_id` (string)
    Example: f93ecfa8-d08a-4325-8694-89aeb89c8f85

  - `errors` (array, required)
    An array of one or more error objects

  - `errors.code` (string, required)
    A string indicating the kind of error, used to further qualify the HTTP response code.
    Example: unauthorized

  - `errors.message` (string)
    Optional. Human readable description of the error.
    Example: Access Token Invalid

## Response 401 fields (application/json):

  - `type` (string, required)
    The type is error.list
    Example: error.list

  - `request_id` (string)
    Example: f93ecfa8-d08a-4325-8694-89aeb89c8f85

  - `errors` (array, required)
    An array of one or more error objects

  - `errors.code` (string, required)
    A string indicating the kind of error, used to further qualify the HTTP response code.
    Example: unauthorized

  - `errors.message` (string)
    Optional. Human readable description of the error.
    Example: Access Token Invalid

## Response 403 fields (application/json):

  - `type` (string, required)
    The type is error.list
    Example: error.list

  - `request_id` (string)
    Example: f93ecfa8-d08a-4325-8694-89aeb89c8f85

  - `errors` (array, required)
    An array of one or more error objects

  - `errors.code` (string, required)
    A string indicating the kind of error, used to further qualify the HTTP response code.
    Example: unauthorized

  - `errors.message` (string)
    Optional. Human readable description of the error.
    Example: Access Token Invalid

## Response 404 fields (application/json):

  - `type` (string, required)
    The type is error.list
    Example: error.list

  - `request_id` (string)
    Example: f93ecfa8-d08a-4325-8694-89aeb89c8f85

  - `errors` (array, required)
    An array of one or more error objects

  - `errors.code` (string, required)
    A string indicating the kind of error, used to further qualify the HTTP response code.
    Example: unauthorized

  - `errors.message` (string)
    Optional. Human readable description of the error.
    Example: Access Token Invalid

