Skip to main content
POST
/
v1
/
proof-of-work
/
app-usage
/
timeline
Fetch Timeline
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    startDate: '2026-02-08 00:00:00',
    endDate: '2026-02-08 23:59:59',
    timeZone: 'Asia/Kolkata',
    userId: ['ab7c4f30-1024-471a-a767-739df0dc53fd'],
    offset: 0,
    limit: 15,
    teamId: []
  })
};

fetch('https://api.trackpilots.com/v1/proof-of-work/app-usage/timeline', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "success": true,
  "statusCode": 200,
  "statusMessage": "Fetched app usage timeline successfully",
  "error": null,
  "data": [
    {
      "user": {
        "userId": "ab7c4f30-1024-471a-a767-739df0dc53fd",
        "name": "Sakthivel Govinthan",
        "profilePicUrl": "https://trackpilots.s3.amazonaws.com/profile-pic/sample.png",
        "emailId": "sakthiveltechit@gmail.com"
      },
      "time": {
        "startTime": "2026-02-14T03:42:39.112Z",
        "endTime": "2026-02-14T03:42:40.667Z",
        "durationInSeconds": 1
      },
      "application": {
        "name": "Google Chrome",
        "iconUrl": "https://vendors.paddle.com/favicon.ico",
        "type": "website",
        "category": "Unknown",
        "domain": "vendors.paddle.com",
        "fullUrl": "https://vendors.paddle.com"
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Either userId or teamId must be provided. Both cannot be empty.

​
startDate
string<date-time>
required
Example:

"2026-02-08 00:00:00"

​
endDate
string<date-time>
required
Example:

"2026-02-08 23:59:59"

​
timeZone
string
required

IANA timezone of the requester

Example:

"Asia/Kolkata"

​
userId
string<uuid>[]
required

List of user UUIDs to fetch screenshots for

​
offset
integer
required
Required range: x >= 0
Example:

0

​
limit
integer
required
Required range: 1 <= x <= 100
Example:

15

​
teamId
string<uuid>[]

List of team UUIDs to fetch screenshots for

Example:
[]

Response

Fetched app usage timeline successfully.

​
success
boolean
Example:

true

​
statusCode
integer
Example:

200

​
statusMessage
string
Example:

"Fetched app usage timeline successfully"

​
error
string | null
Example:

null

​
data
object[]