Get big picture data for a project

What is Big Picture? Big Picture is a visual overview of all tasks in a project, organized by task type (like Feature, Bug, or Management). It provides a quick way to assess project status, priorities, bottlenecks, and time efforts without diving into individual task details. This view is especially useful for project members who need a high-level understanding of project progress.

Visual structure: The Big Picture displays tasks as cards arranged in horizontal rows. Each row represents a task type (e.g., Feature, Bug, Management). Within each row, tasks are sorted from left to right by priority - tasks further to the left have higher priority than those to the right.

What data is returned: The response includes:

• Groups: Array of task groups, where each group represents a task type (row). Each group contains:
  • Task items (cards): Each card represents a single task and includes:
    • Task status (color-coded: New, In Progress, Feedback, Resolved, Backlog)
    • Task ID, title, and short description
    • Priority level and task type
    • Time information: planned hours vs spent hours (e.g., “11.8 h / 40 h”)
    • Due date warnings if applicable
    • Comment count and pipeline status indicator
    • Tags and assigned people (responsible person and stakeholders)
  • Group statistics: Metrics for that specific task type:
    • Number of resolved tasks
    • Total estimated hours for all tasks in the group
    • Total spent hours across all tasks in the group
    • Resolved hours (time spent on completed tasks)
• Overall statistics: Aggregated metrics across all tasks in the project:
  • Total number of tasks
  • Number of resolved tasks
  • Total estimated hours
  • Total spent hours
  • Resolved hours

Task grouping: Tasks are grouped by their task type. Tasks without a recognized type are grouped into a special “other” category. Groups are sorted according to the configured task type order (which can be changed using the group-order endpoint).

Use cases:

• Quick project status assessment without opening individual tasks
• Identifying bottlenecks and overload situations by comparing estimated vs spent hours
• Prioritizing customer requests visually - arrange tasks left to right based on importance
• Getting an overview when covering for absent team members - see priorities and status at a glance
• Visual project planning and coordination - understand what needs attention most urgently
• Communicating priorities to customers - show them which tasks matter most

Permissions: Requires BigPicture.canView permission and access to the specified project.

Note: If you need to retrieve all tasks with custom filtering, sorting, or pagination capabilities, consider using the GET /tasks/grid endpoint instead. The grid endpoint provides more flexible filtering options and is better suited for retrieving large datasets or when you need to filter by multiple criteria simultaneously.

curl -X GET "https://leadtime.app/api/public/tasks/bigPicture?projectId=7225cca9-ac5f-461d-9a9d-ad8d7ee1b597" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

const response = await fetch("https://leadtime.app/api/public/tasks/bigPicture?projectId=7225cca9-ac5f-461d-9a9d-ad8d7ee1b597", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  }
});

import requests

response = requests.get(
    "https://leadtime.app/api/public/tasks/bigPicture?projectId=7225cca9-ac5f-461d-9a9d-ad8d7ee1b597",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    },
)

{
  "groups": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "items": [
        {
          "assignedUserId": "user-uuid-1",
          "estimatedHours": 8,
          "id": "task-uuid-1",
          "isInPipeline": true,
          "itemStatus": 1,
          "lastComment": null,
          "priority": "High",
          "spentHours": 4.5,
          "status": "In Progress",
          "title": "Implement user authentication",
          "typeId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
        }
      ],
      "stats": {
        "resolvedCount": 2,
        "resolvedHours": 4,
        "totalEstimate": 16,
        "totalSpent": 8
      }
    }
  ],
  "stats": {
    "resolvedCount": 3,
    "resolvedHours": 10,
    "totalEstimate": 40,
    "totalSpent": 20,
    "totalTasks": 10
  }
}