---
search:
  tags:
    - insights
    - GET
seo:
  description: >-
    What are Goal Insights? Goal Insights provides detailed analysis of…
    Reference for the GET /insights/goal-chart endpoint in the Leadtime Public
    API API.
sidebar:
  badge: GET
  label: Get goal insights data in structured JSON format
title: Get goal insights data in structured JSON format
type: openapi-operation
---
**What are Goal Insights?**
Goal Insights provides detailed analysis of employee time tracking goal progress, showing how team members perform against their attendance, booked hours, and billable hours targets. This helps managers track productivity, identify employees who need support, and ensure team members are meeting their performance goals.

**What data is returned:**
The response includes two "sheets" of data in JSON format (matching the Excel export structure):
- **Goal Progress sheet**: Employee time tracking goals with goal and actual values for:
  - Attendance (optional, based on workspace settings)
  - Booked hours (total time logged)
  - Billable hours (chargeable time logged)
- **Value Distribution sheet**: Breakdown of hours by value groups (A, B, C, D) showing how time is categorized by value

**Supported display modes:**
- **INDIVIDUAL mode**: One row per employee showing their individual goals and actuals. Perfect for tracking individual performance.
- **TOTAL mode**: Single aggregated row with combined totals across all selected employees. Useful for team-level overview.

**Time frame options:**
- TODAY: Current day's goal progress
- WEEK: Current week's goal progress
- MONTH: Current month's goal progress
- QUARTER: Current quarter's goal progress

**Goal types explained:**
- **Attendance Goal**: Target hours for employee presence (if attendance tracking is enabled)
- **Booked Goal**: Target hours for total time logged (all work activities)
- **Billable Goal**: Target hours for chargeable/billable work (revenue-generating activities)

**Value groups:**
Hours are categorized into value groups based on project and task settings:
- **Group A**: Highest value work (premium projects/tasks)
- **Group B**: High value work
- **Group C**: Standard value work
- **Group D**: Lower value work

**Special features:**
- Attendance columns are conditionally included based on workspace settings (only shown if attendance tracking is enabled)
- All headers and titles are fully localized based on user's language preference
- Human-readable employee names (never UUIDs)
- Goal vs actual comparison makes it easy to identify performance gaps

**Use cases:**
- Track individual employee goal achievement
- Monitor team-level goal performance
- Identify employees who need support to meet goals
- Analyze value group distribution to optimize time allocation
- Export to Excel for performance reviews and reporting

<Operation source="api-reference" id="insightscontroller-getgoalchart" />