Skip to content
Developers
Teams

Get the teams board

View Markdown

GET /teams/board

GET
/teams/board

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Query Parameters

week_start?string

First week of the board; snaps to its Sunday. Defaults to today.

weeks?string

How many weeks the board covers and every figure averages over, 1 to 12. Defaults to 8.

team_id?string

Return only this team. projectsNotInAPod is omitted when set.

Response Body

application/json

curl -X GET "https://app.supervisible.com/api/v1/teams/board"
{
  "data": {
    "weekStart": "2026-01-04",
    "summaryWeeks": 8,
    "note": "Loads and hours are averages per week over all 8 weeks, the same as the app's 8-week view. \"team\" hours are the owning team's members, \"shared\" anyone else, \"unstaffed\" placeholders with no one assigned.",
    "teams": [
      {
        "id": "019cb675-c4d6-7e90-8806-25e5145c3a07",
        "name": "Pod 3",
        "isPod": true,
        "manager": {
          "id": "019cb675-c4df-7f8b-8a83-5f28581f5e7e",
          "name": "Juan Méndez",
          "title": "Design lead"
        },
        "loadPercent": 75,
        "perWeek": {
          "availableHours": 40,
          "bookedHours": 30
        },
        "outlook": [
          {
            "weekStart": "2026-01-04",
            "availableHours": 40,
            "bookedHours": 30
          }
        ],
        "members": [
          {
            "id": "019cb675-c4df-7f8b-8a83-5f28581f5e7e",
            "name": "Juan Méndez",
            "title": "Design lead",
            "loadPercent": 75,
            "perWeek": {
              "availableHours": 40,
              "bookedHours": 30
            },
            "weeksOverCapacity": 0
          }
        ],
        "clients": [
          {
            "id": "019cb675-c4d6-7e90-8806-25e5145c3a08",
            "name": "Acme",
            "hoursPerWeek": {
              "team": 30,
              "shared": 0,
              "unstaffed": 0,
              "total": 30
            },
            "projects": [
              {
                "id": "019cb675-c4d6-7e90-8806-25e5145c3a06",
                "displayId": "PRJ-12",
                "name": "CRM Sync Project",
                "startDate": "2026-01-01",
                "endDate": "2026-03-01",
                "hoursPerWeek": {
                  "team": 30,
                  "shared": 0,
                  "unstaffed": 0,
                  "total": 30
                },
                "signal": null
              }
            ]
          }
        ],
        "worksOn": [],
        "attention": {
          "overMemberIds": [],
          "endingProjectIds": [],
          "unbookedProjectIds": []
        }
      }
    ],
    "projectsNotInAPod": [],
    "totals": {
      "people": 1,
      "clients": 1,
      "loadPercent": 75,
      "perWeek": {
        "availableHours": 40,
        "bookedHours": 30
      }
    }
  }
}
Empty
Empty
Empty
Empty
Empty
Empty