Fetch Timeline - Trackpilots

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));

curl --request POST \
  --url https://api.trackpilots.com/v1/proof-of-work/app-usage/timeline \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "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": []
}
'

import requests

url = "https://api.trackpilots.com/v1/proof-of-work/app-usage/timeline"

payload = {
    "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": []
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

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

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));

curl --request POST \
  --url https://api.trackpilots.com/v1/proof-of-work/app-usage/timeline \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "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": []
}
'

import requests

url = "https://api.trackpilots.com/v1/proof-of-work/app-usage/timeline"

payload = {
    "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": []
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

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

Option 1
Option 2

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[]

Show child attributes