---
title: "Check when hosts all work"
method: GET
path: "/api/v1/teams/{team}/shared-hours"
tags: ["account"]
---

# Check when hosts all work

`GET /api/v1/teams/{team}/shared-hours`

## Request

- Base URL: `https://meettempi.com`
- URL: `https://meettempi.com/api/v1/teams/{team}/shared-hours`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `tempi_session`

For a collective event type: when all of these hosts are in their working hours over the next `days` days, counting days off and each host's time zone, not calendars. Returns the shared time, the hours per week, and how many meetings of `durationMinutes` could start per week. Collective event types only offer times inside it. Any member can call it.

## Path parameters

- `team` string, required: the id or slug of a team you belong to

## Query parameters

- `hostIds` string, required: the hosts' user ids from get_team, separated by commas (2 to 20)
- `durationMinutes` union: a meeting length in minutes between 5 and 480 (default 30)
  - integer: an integer
  - string: a string to be decoded into a number
- `days` union: how many days ahead to look, between 7 and 28 (default 14)
  - integer: an integer
  - string: a string to be decoded into a number

## Response `200`

Success

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/meettempi/apis/tempi-api.md) · [All operations](https://skmtc.dev/meettempi/apis/tempi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/meettempi/apis/tempi-api/revisions/36787210a2ce?raw)