Skip to main content
GET
/
v1
/
reading_sessions
curl "https://api.getmatter.com/public/v1/reading_sessions" \
  -H "Authorization: Bearer mat_your_token_here"

{
  "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..."
}

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.

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

​
since
string
Only return sessions on or after this ISO 8601 datetime. Useful for incremental sync. Example: 2026-04-01T00:00:00Z.
​
limit
integer
default:25
Number of sessions per page. Min 1, max 100.
​
cursor
string
Cursor for the next page of results.

​
Response

​
object
string
required
Always "list".
​
results
array
required
Array of reading session objects, ordered by date descending (newest first).
​
has_more
boolean
required
Whether there are more results.
​
next_cursor
string
Cursor for the next page.
curl "https://api.getmatter.com/public/v1/reading_sessions" \
  -H "Authorization: Bearer mat_your_token_here"

{
  "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..."
}