---
title: "List every member's invitation link (admin)"
method: GET
path: "/api/admin/invites"
---

# List every member's invitation link (admin)

`GET /api/admin/invites`

## Request

- Base URL: `https://www.toma.com`
- URL: `https://www.toma.com/api/admin/invites`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `better-auth.session_token`

Toma staff only (a verified @toma.so or @toma.com address). Most used first. Pass nextOffset as offset for the next page; it is null on the last. Same as the list_invite_links MCP tool.

## Query parameters

- `offset` integer: Requests to skip: the nextOffset of the previous page. Default 0.
- `limit` integer: Requests to return. Default 50.

## Response `200`

One page of invitation links.

- object
  - `inviteLinks` StaffInviteLink[], required
    - `id` string, required
    - `link` string, uri, required
    - `uses` integer, required
    - `createdAt` string, date-time, required
    - `revokedAt` string, date-time, nullable, required
    - `owner` object, required
      - `id` string, required
      - `name` string, required
      - `email` string, required
  - `nextOffset` integer, nullable, required: The next page's offset; null on the last page.

## Other responses

- `400`: offset or limit is out of range.
- `401`: No valid session or API key.
- `403`: Not Toma staff.

---

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