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

# List Reading Sessions

> Returns a paginated list of reading sessions for the authenticated user.

Each session records a single reading period with a timestamp and duration.
Use these to compute reading streaks, daily totals, or other time-based
statistics client-side.

## Query Parameters

<ParamField query="since" type="string">
  Only return sessions on or after this ISO 8601 datetime. Useful for incremental sync.
  Example: `2026-04-01T00:00:00Z`.
</ParamField>

<ParamField query="limit" type="integer" default={25}>
  Number of sessions per page. Min 1, max 100.
</ParamField>

<ParamField query="cursor" type="string">
  Cursor for the next page of results.
</ParamField>

## Response

<ResponseField name="object" type="string" required>
  Always `"list"`.
</ResponseField>

<ResponseField name="results" type="array" required>
  Array of reading session objects, ordered by date descending (newest first).

  <Expandable title="reading session properties">
    <ResponseField name="object" type="string">Always `"reading_session"`.</ResponseField>
    <ResponseField name="id" type="string">Reading session ID (e.g. `rs_k8x2m`).</ResponseField>
    <ResponseField name="date" type="string">When the session occurred (ISO 8601, UTC).</ResponseField>
    <ResponseField name="seconds_read" type="integer">Duration of the session in seconds.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="has_more" type="boolean" required>
  Whether there are more results.
</ResponseField>

<ResponseField name="next_cursor" type="string">
  Cursor for the next page.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.getmatter.com/public/v1/reading_sessions" \
    -H "Authorization: Bearer mat_your_token_here"
  ```

  ```bash cURL (with since filter) theme={null}
  curl "https://api.getmatter.com/public/v1/reading_sessions?since=2026-04-01T00:00:00Z" \
    -H "Authorization: Bearer mat_your_token_here"
  ```

  ```python Python theme={null}
  response = requests.get(
      "https://api.getmatter.com/public/v1/reading_sessions",
      headers={"Authorization": f"Bearer {token}"},
      params={"since": "2026-04-01T00:00:00Z"}
  )
  sessions = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "object": "list",
    "results": [
      {
        "object": "reading_session",
        "id": "rs_k8x2m",
        "date": "2026-04-09T14:23:00Z",
        "seconds_read": 180
      },
      {
        "object": "reading_session",
        "id": "rs_j7w1n",
        "date": "2026-04-09T08:12:00Z",
        "seconds_read": 162
      },
      {
        "object": "reading_session",
        "id": "rs_h6v0p",
        "date": "2026-04-08T21:45:00Z",
        "seconds_read": 480
      }
    ],
    "has_more": true,
    "next_cursor": "eyJ1YSI6MTc..."
  }
  ```
</ResponseExample>