> ## Documentation Index
> Fetch the complete documentation index at: https://docs.series.hr/llms.txt
> Use this file to discover all available pages before exploring further.

# Get User Sessions

> Retrieve session history for a user

Get a list of all gaming sessions for a specific user, including join and leave times. Requires either a single date or a date range.

## Request

```bash theme={null}
# Single date
curl -X GET "https://api.series.hr/activity/sessions/714760171?date=2024-01-15" \
  -H "apikey: YOUR_API_KEY"

# Date range
curl -X GET "https://api.series.hr/activity/sessions/714760171?start=2024-01-01&end=2024-01-31" \
  -H "apikey: YOUR_API_KEY"
```

## Parameters

<ParamField path="userId" type="string" required>
  The Roblox user ID
</ParamField>

<ParamField query="date" type="string">
  Single date to query (format: YYYY-MM-DD). Either this or both start/end must be provided.
</ParamField>

<ParamField query="start" type="string">
  Start date for range query (format: YYYY-MM-DD). Must be used with end parameter.
</ParamField>

<ParamField query="end" type="string">
  End date for range query (format: YYYY-MM-DD). Must be used with start parameter.
</ParamField>

<ParamField query="page" type="integer">
  Page number for pagination (default: 1)
</ParamField>

## Response

<ResponseField status={200} name="200">
  ```json theme={null}
  {
    "success": true,
    "data": {
      "userId": "714760171",
      "sessions": [
        {
          "sessionId": "session_12345",
          "placeId": "9876543210",
          "joinTime": "2024-01-15T10:30:00Z",
          "leaveTime": "2024-01-15T11:45:00Z",
          "duration": 4500
        }
      ]
    }
  }
  ```
</ResponseField>


## OpenAPI

````yaml GET /activity/sessions/{userId}
openapi: 3.0.0
info:
  title: Series API
  version: 1.0.0
  description: >-
    Series API — a free REST API by Sailboat Games, LLC that lets Roblox
    communities programmatically manage workspaces, staff, sessions, time-off
    and activity data.
  contact:
    name: Sailboat Games, LLC.
    email: admin@sailboatgames.com
servers:
  - url: https://api.series.hr
    description: Production API
security:
  - ApiKeyAuth: []
paths:
  /activity/sessions/{userId}:
    get:
      tags:
        - Activity
      summary: Get User Sessions
      description: >-
        Retrieve session history for a user. Requires either date or both start
        and end parameters.
      parameters:
        - name: userId
          in: path
          required: true
          schema:
            type: string
        - name: date
          in: query
          required: false
          schema:
            type: string
            format: date
          description: Single date to query (YYYY-MM-DD)
        - name: start
          in: query
          required: false
          schema:
            type: string
            format: date
          description: Start date for range query (YYYY-MM-DD)
        - name: end
          in: query
          required: false
          schema:
            type: string
            format: date
          description: End date for range query (YYYY-MM-DD)
        - name: page
          in: query
          required: false
          schema:
            type: integer
          description: 'Page number for pagination (default: 1)'
      responses:
        '200':
          description: User sessions
        '400':
          description: Either date or start/end parameters are required
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: apikey
      description: >-
        Pass your API key in the `apikey` header. Alternatively, the `x-api-key`
        header is also accepted.

````