---
title: "List Team Invites"
method: GET
path: "/v2/teams/{team_id}/invites"
tags: ["v2 - Team Invites"]
---

# List Team Invites

`GET /v2/teams/{team_id}/invites`

## Request

- Base URL: `https://api.jubjubapp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.jubjubapp.com/v2/teams/{team_id}/invites`
- Auth: HTTP bearer

List all invites for a team.

Requires MEMBERS_VIEW permission.
Can filter by status: pending, accepted, rejected, expired, cancelled.

The filter is accepted under two names. The dashboard sends
`status_filter`; the MCP tool `teams_invites_list` sends `status`, and
until 2026-10-09 FastAPI silently dropped that unknown query key, so an
agent asking for `pending` got every invite the team ever sent. An
unknown value matches nothing, as it always did.

## Path parameters

- `team_id` string, required

## Query parameters

- `status_filter` string, nullable: Filter: pending, accepted, rejected, expired, cancelled.
- `status` string, nullable: Same filter under the name the MCP tool and its schema use.

## Headers

- `Authorization` string
- `X-JubJub-Service-Key` string
- `X-JubJub-Agent-Key` string
- `X-JubJub-Platform-Key` string
- `Origin` string
- `Referer` string
- `X-JubJub-Trial-Token` string

## Response `200`

Successful Response

- InviteListResponse: List of invitations.
  - `invites` InviteResponse[], required
    - `invite_id` string, required
    - `team_id` string, required
    - `team_name` string, required
    - `team_avatar_url` string, nullable
    - `inviter_profile_id` string, nullable
    - `inviter_email` string, nullable
    - `inviter_name` string, nullable
    - `inviter` PublicPersonResponse: Another person as anyone may see them (founder's rule, 2026-09-25). Never a profile ID, never an email. `member_ref` is the opaque, per-context handle routes accept for this person (null where there is no context to mint one in). `display_name` is a public name or, with none, the person's role and team where the response knows them ("Admin (via Kong)"), else "Member" (2026-10-08; never "JubJub member").
      - `member_ref` string, nullable
      - `display_name` string, required
      - `avatar_url` string, nullable
      - `handle` string, nullable
      - `is_you` boolean
      - `role` string, nullable
      - `via_team` string, nullable
    - `invitee_email` string, required
    - `invitee_email_masked` boolean
    - `invitee_profile_id` string, nullable
    - `invitee` PublicPersonResponse: Another person as anyone may see them (founder's rule, 2026-09-25). Never a profile ID, never an email. `member_ref` is the opaque, per-context handle routes accept for this person (null where there is no context to mint one in). `display_name` is a public name or, with none, the person's role and team where the response knows them ("Admin (via Kong)"), else "Member" (2026-10-08; never "JubJub member").
      - `member_ref` string, nullable
      - `display_name` string, required
      - `avatar_url` string, nullable
      - `handle` string, nullable
      - `is_you` boolean
      - `role` string, nullable
      - `via_team` string, nullable
    - `is_mine` boolean
    - `is_for_you` boolean
    - `role` string, required
    - `custom_permissions` string[], nullable
    - `status` string, required
    - `created_at` string, date-time, required
    - `expires_at` string, date-time, required
    - `responded_at` string, date-time, nullable
    - `expires_in_days` integer
    - `email_dispatched` boolean, nullable
    - `email_error` string, nullable
    - `email_sent_at` string, date-time, nullable
    - `invite_url` string, nullable
  - `total` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/jubjubapp/apis/jubjub-api.md) - [All operations](https://skmtc.dev/jubjubapp/apis/jubjub-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jubjubapp/apis/jubjub-api/revisions/353157b296f2?raw)