---
title: "List team (owner + members + pending invitations)"
method: GET
path: "/api/v1/team"
tags: ["Team"]
---

# List team (owner + members + pending invitations)

`GET /api/v1/team`

## Request

- Base URL: `https://www.gerezi.com`
- URL: `https://www.gerezi.com/api/v1/team`
- Auth: HTTP bearer

Returns the restaurant's owner, accepted members, and PENDING invitations. Scope: `team:read`. Org-level keys must pass `restaurant_id` as a query param.

## Query parameters

- `restaurant_id` string

## Response `200`

Team roster

- object
  - `data` object
    - `owner` object
      - `id` string
      - `name` string, nullable
      - `email` string
      - `role` string
      - `status` string
    - `members` object[]
      - `id` string
      - `role` 'MANAGER' | 'STAFF'
      - `user` object
        - `id` string
        - `email` string
        - `name` string, nullable
    - `invitations` object[]
      - `id` string
      - `email` string
      - `role` string
      - `status` string
      - `expires_at` string, date-time

## Other responses

- `401`: Missing or invalid API key
- `403`: Key lacks required scope

---

[API](https://skmtc.dev/gerezi/apis/gerezi-restaurant-api.md) · [All operations](https://skmtc.dev/gerezi/apis/gerezi-restaurant-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gerezi/apis/gerezi-restaurant-api/revisions/323b530e81cb?raw)