Time Data · Timeglass API

Tracked activities, their fine-grained items, and member-day timesheets built from them.

List Activities

GET /v1/activities

Activity records: one row per member, day, and project grouping, with AI-written objectives. Durations are minutes of tracked work.

Query parameters

  • limit · integer
  • cursor · string
  • start · string · date (YYYY-MM-DD)
  • end · string · date (YYYY-MM-DD)
  • member_id · string
  • team_id · string · uuid
  • project_id · string · uuid
  • client_id · string · uuid
  • category_id · string · uuid

Response 200

  • data · array of object · required
    • activity_id · string · uuid · required
    • member_id · string · required
    • date · string · required
    • team_id · string · uuid · nullable · required
    • project_id · string · uuid · nullable · required
    • client_id · string · uuid · nullable · required
    • category_id · string · uuid · nullable · required
    • objective · string · nullable · required
    • duration_minutes · number · required
    • activity_item_count · number · nullable · required
    • latest_activity_at · string · nullable · required
    • review_status · string · nullable · required
  • next_cursor · string · nullable · required
curl "https://api.timeglass.ai/v1/activities" \
  -H "Authorization: Bearer $TIMEGLASS_API_KEY"

Get an Activity

GET /v1/activities/{activityId}

Path parameters

  • activityId · string · uuid · required

Response 200

  • activity_id · string · uuid · required
  • member_id · string · required
  • date · string · required
  • team_id · string · uuid · nullable · required
  • project_id · string · uuid · nullable · required
  • client_id · string · uuid · nullable · required
  • category_id · string · uuid · nullable · required
  • objective · string · nullable · required
  • duration_minutes · number · required
  • activity_item_count · number · nullable · required
  • latest_activity_at · string · nullable · required
  • review_status · string · nullable · required
  • actions · string · nullable · required
  • key_details · string · nullable · required
curl "https://api.timeglass.ai/v1/activities/4bfe4a4b-c86b-4b8e-b3f5-3d1c4a2e9f10" \
  -H "Authorization: Bearer $TIMEGLASS_API_KEY"

List Activity Items

GET /v1/activities/{activityId}/items

The fine-grained work segments inside one activity, in chronological order: what was worked on, in which apps, for how long.

Path parameters

  • activityId · string · uuid · required

Query parameters

  • limit · integer
  • cursor · string

Response 200

  • data · array of object · required
    • activity_item_id · string · uuid · required
    • start_time · string · required
    • end_time · string · nullable · required
    • duration_minutes · number · required
    • objective · string · nullable · required
    • actions · string · nullable · required
    • key_details · string · nullable · required
    • apps · array of string · nullable · required
  • next_cursor · string · nullable · required
curl "https://api.timeglass.ai/v1/activities/4bfe4a4b-c86b-4b8e-b3f5-3d1c4a2e9f10/items" \
  -H "Authorization: Bearer $TIMEGLASS_API_KEY"

List Timesheets

GET /v1/timesheets

One timesheet per member per day: the day’s activities plus roll-up metadata (total time, review status). A timesheet is approved once every activity in it is approved. For finer slicing (by project, client, or category), query /v1/activities.

Query parameters

  • limit · integer
  • cursor · string
  • start · string · date (YYYY-MM-DD)
  • end · string · date (YYYY-MM-DD)
  • member_id · string
  • status · string · One of: pending, approved

Response 200

  • data · array of object · required
    • member_id · string · required
    • date · string · required
    • status · string · required · One of: pending, approved
    • approved_at · string · nullable · required
    • total_duration_minutes · number · required
    • activity_count · number · required
    • activities · array of object · required
      • activity_id · string · uuid · required
      • team_id · string · uuid · nullable · required
      • project_id · string · uuid · nullable · required
      • client_id · string · uuid · nullable · required
      • category_id · string · uuid · nullable · required
      • objective · string · nullable · required
      • duration_minutes · number · required
      • status · string · required · One of: pending, approved
  • next_cursor · string · nullable · required
curl "https://api.timeglass.ai/v1/timesheets" \
  -H "Authorization: Bearer $TIMEGLASS_API_KEY"