Skip to main content
GET
/
activity
/
time-played
/
{userId}
Get Time Played
curl --request GET \
  --url https://api.series.hr/activity/time-played/{userId} \
  --header 'apikey: <api-key>'
Get the total time a user has spent playing across all places. Requires either a single date or a date range.

​
Request

# Single date
curl -X GET "https://api.series.hr/activity/time-played/714760171?date=2024-01-15" \
  -H "apikey: YOUR_API_KEY"

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

​
Parameters

​
userId
string
required
The Roblox user ID
​
date
string
Single date to query (format: YYYY-MM-DD). Either this or both start/end must be provided.
​
start
string
Start date for range query (format: YYYY-MM-DD). Must be used with end parameter.
​
end
string
End date for range query (format: YYYY-MM-DD). Must be used with start parameter.

​
Response

​
200
{
  "success": true,
  "data": {
    "userId": "714760171",
    "totalSecondsPlayed": 7200,
    "totalHoursPlayed": 2.0
  }
}

Authorizations

​
apikey
string
header
required

Pass your API key in the apikey header. Alternatively, the x-api-key header is also accepted.

Path Parameters

​
userId
string
required

Query Parameters

​
date
string<date>

Single date to query (YYYY-MM-DD)

​
start
string<date>

Start date for range query (YYYY-MM-DD)

​
end
string<date>

End date for range query (YYYY-MM-DD)

Response

Playtime data