## Fetch participants list of a session

`client.RealtimeKit.Sessions.GetSessionParticipants(ctx, appID, sessionID, params) (*SessionGetSessionParticipantsResponse, error)`

**get** `/accounts/{account_id}/realtime/kit/{app_id}/sessions/{session_id}/participants`

Returns a list of participants for the given session ID.

### Parameters

- `appID string`

  The app identifier tag.

- `sessionID string`

- `params SessionGetSessionParticipantsParams`

  - `AccountID param.Field[string]`

    Path param: The account identifier tag.

  - `IncludePeerEvents param.Field[bool]`

    Query param: if true, response includes all the peer events of participants.

  - `PageNo param.Field[float64]`

    Query param: The page number from which you want your page search results to be displayed.

  - `PerPage param.Field[float64]`

    Query param: Number of results per page

  - `Search param.Field[string]`

    Query param: The search query string. You can search using the meeting ID or title.

  - `SortBy param.Field[SessionGetSessionParticipantsParamsSortBy]`

    Query param

    - `const SessionGetSessionParticipantsParamsSortByJoinedAt SessionGetSessionParticipantsParamsSortBy = "joinedAt"`

    - `const SessionGetSessionParticipantsParamsSortByDuration SessionGetSessionParticipantsParamsSortBy = "duration"`

  - `SortOrder param.Field[SessionGetSessionParticipantsParamsSortOrder]`

    Query param

    - `const SessionGetSessionParticipantsParamsSortOrderAsc SessionGetSessionParticipantsParamsSortOrder = "ASC"`

    - `const SessionGetSessionParticipantsParamsSortOrderDesc SessionGetSessionParticipantsParamsSortOrder = "DESC"`

  - `View param.Field[SessionGetSessionParticipantsParamsView]`

    Query param: In breakout room sessions, the view parameter can be set to `raw` for session specific duration for participants or `consolidated` to accumulate breakout room durations.

    - `const SessionGetSessionParticipantsParamsViewRaw SessionGetSessionParticipantsParamsView = "raw"`

    - `const SessionGetSessionParticipantsParamsViewConsolidated SessionGetSessionParticipantsParamsView = "consolidated"`

### Returns

- `type SessionGetSessionParticipantsResponse struct{…}`

  - `Data SessionGetSessionParticipantsResponseData`

    - `Participants []SessionGetSessionParticipantsResponseDataParticipant`

      - `ID string`

        Participant ID. This maps to the corresponding peerId.

      - `CreatedAt string`

        timestamp when this participant was created.

      - `CustomParticipantID string`

        ID passed by client to create this participant.

      - `DisplayName string`

        Display name of participant when joining the session.

      - `Duration float64`

        number of minutes for which the participant was in the session.

      - `JoinedAt string`

        timestamp at which participant joined the session.

      - `LeftAt string`

        timestamp at which participant left the session.

      - `PresetName string`

        Name of the preset associated with the participant.

      - `UpdatedAt string`

        timestamp when this participant's data was last updated.

      - `UserID string`

        User id for this participant.

  - `Success bool`

### Example

```go
package main

import (
  "context"
  "fmt"

  "github.com/cloudflare/cloudflare-go"
  "github.com/cloudflare/cloudflare-go/option"
  "github.com/cloudflare/cloudflare-go/realtime_kit"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  response, err := client.RealtimeKit.Sessions.GetSessionParticipants(
    context.TODO(),
    "app_id",
    "session_id",
    realtime_kit.SessionGetSessionParticipantsParams{
      AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", response.Data)
}
```

#### Response

```json
{
  "data": {
    "paging": {
      "end_offset": 2,
      "start_offset": 1,
      "total_count": 123
    },
    "participants": [
      {
        "created_at": "2023-02-01T10:51:08.039Z",
        "custom_participant_id": "83qi0i",
        "display_name": "Mark",
        "duration": 5.8097,
        "id": "005f4e0c-4d08-4d4e-a391-a76be75cd296",
        "joined_at": "2023-02-01T10:51:08.030Z",
        "left_at": "2023-02-01T10:56:56.612Z",
        "preset_name": "webinar_participant",
        "updated_at": "2023-02-01T10:56:56.618Z",
        "user_id": "0a08343d-a9dc-45f0-9feb-6a64afcc4f81"
      },
      {
        "created_at": "2023-02-01T10:50:36.853Z",
        "custom_participant_id": "3uggr",
        "display_name": "Henry",
        "duration": 6.9263,
        "id": "51fdf95f-d893-471a-922b-7db7adb14453",
        "joined_at": "2023-02-01T10:50:36.846Z\"",
        "left_at": "2023-02-01T10:57:32.424Z",
        "preset_name": "webinar_participant",
        "updated_at": "2023-02-01T10:57:32.431Z",
        "user_id": "85e7f0fd-7c16-45e9-9d68-f17ef007c4eb"
      }
    ]
  },
  "success": true
}
```