---
title: "Members, roles and open invitations"
method: GET
path: "/team"
tags: ["Team"]
---

# Members, roles and open invitations

`GET /team`

## Request

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

Lists the account's members with their roles (owner, admin, member) and the open invitations with their status and email delivery status. Everyone on the team sees this list in the app. Roles: the owner manages everything, including admins and the plan; an admin invites and manages ordinary members; a member uses the shared projects but manages nobody. All members share the account's projects, history and plan.

## Response `200`

Members, roles and open invitations

- object
  - `your_role` 'owner' | 'admin' | 'member', required: Role of the person the credential acts for.
  - `members` object[], required
    - `user_id` string, required
    - `email` string, required
    - `role` 'owner' | 'admin' | 'member', required
    - `joined_at` string, required
    - `you` boolean, required: True for the person the credential acts for.
  - `invitations` object[], required: Open invitations, newest first, including expired ones that were not replaced.
    - `id` string, required
    - `email` string, required
    - `role` 'admin' | 'member', required
    - `status` 'pending' | 'expired' | 'accepted' | 'canceled', required: pending invitations can still be accepted until expires_at.
    - `delivery_status` 'pending' | 'sent' | 'failed', required: Whether the invitation email was handed to the mail service.
    - `invited_by_email` string, nullable, required
    - `created_at` string, required
    - `expires_at` string, required
  - `seat_limit` integer, required: Members plus open, unexpired invitations may not exceed this.
  - `request_id` string

## Other responses

- `400`: Invalid parameters, cursor or body.
- `401`: Missing, invalid, expired or revoked credential.
- `403`: The credential lacks the write scope, the plan does not include the API, or the allowance is used up.
- `404`: Unknown project, keyword or run in this account.
- `409`: The idempotency key was already used for a different request.
- `429`: Rate limit reached. Retry after the Retry-After seconds.
- `503`: The requested service or file is temporarily unavailable.

---

[API](https://skmtc.dev/adslighthouse/apis/ads-lighthouse-api.md) · [All operations](https://skmtc.dev/adslighthouse/apis/ads-lighthouse-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adslighthouse/apis/ads-lighthouse-api/revisions/e1a4a40b11a9?raw)