---
title: "List pending team invitations"
method: GET
path: "/orgs/{org}/teams/{team_slug}/invitations"
tags: ["teams"]
---

# List pending team invitations

`GET /orgs/{org}/teams/{team_slug}/invitations`

The return hash contains a `role` field which refers to the Organization Invitation role and will be one of the following values: `direct_member`, `admin`, `billing_manager`, `hiring_manager`, or `reinstate`. If the invitee is not a GitHub member, the `login` field in the return hash will be `null`.

> [!NOTE]
> You can also specify a team by `org_id` and `team_id` using the route `GET /organizations/{org_id}/team/{team_id}/invitations`.

## Path parameters

- `org` string, required
- `team_slug` string, required

## Query parameters

- `per_page` integer
- `page` integer

## Response `200`

Response

- OrganizationInvitation[]
  - `id` integer, required
  - `login` string, nullable, required
  - `email` string, nullable, required
  - `role` string, required
  - `created_at` string, required
  - `failed_at` string, nullable
  - `failed_reason` string, nullable
  - `inviter` SimpleUser, required — A GitHub user.
    - `name` string, nullable
    - `email` string, nullable
    - `login` string, required
    - `id` integer, required
    - `node_id` string, required
    - `avatar_url` string, uri, required
    - `gravatar_id` string, nullable, required
    - `url` string, uri, required
    - `html_url` string, uri, required
    - `followers_url` string, uri, required
    - `following_url` string, required
    - `gists_url` string, required
    - `starred_url` string, required
    - `subscriptions_url` string, uri, required
    - `organizations_url` string, uri, required
    - `repos_url` string, uri, required
    - `events_url` string, required
    - `received_events_url` string, uri, required
    - `type` string, required
    - `site_admin` boolean, required
    - `starred_at` string
    - `user_view_type` string
  - `team_count` integer, required
  - `node_id` string, required
  - `invitation_teams_url` string, required
  - `invitation_source` string

## Other responses

- `422` — Unprocessable entity if you attempt to modify an enterprise team at the organization level.

---

[API](https://skmtc.net/github/apis/api-github-com.md) · [All operations](https://skmtc.net/github/apis/api-github-com/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/github/api-github-com/revisions/a367f7028301/schema)