---
title: "List the invitations into a Workspace the person owns or administers, newest first, with their status."
method: GET
path: "/api/v2/workspaces/{id}/invitations"
---

# List the invitations into a Workspace the person owns or administers, newest first, with their status.

`GET /api/v2/workspaces/{id}/invitations`

## Request

- Base URL: `https://fintable.io`
- URL: `https://fintable.io/api/v2/workspaces/{id}/invitations`
- Auth: HTTP bearer

Requires a role that manages members (Owner or Admin; 403 otherwise). The Workspace must be selectable by the credential (default, legacy personal or granted); otherwise 404. Lists pending, accepted and expired invitations (pending first, then newest, up to 200); revoked ones are omitted, so an integration can tell whether a client has accepted.

## Path parameters

- `id` string, required

## Response `200`

The Workspace's pending, accepted and expired invitations: pending first, then newest, up to 200.

- WorkspaceInvitationList
  - `data` WorkspaceInvitation[]
    - `id` string: Opaque invitation ID (inv_...).
    - `email` string: The invited address, lowercased.
    - `role` 'admin' | 'editor' | 'viewer': The role the invitee receives on accepting.
    - `status` 'pending' | 'accepted' | 'revoked' | 'expired': pending until the invitee accepts (accepted), the inviter revokes it (revoked) or seven days pass (expired).
    - `created_at` string, date-time, nullable
    - `expires_at` string, date-time
    - `accepted_at` string, date-time, nullable
    - `revoked_at` string, date-time, nullable

## Other responses

- `403`: The standard error envelope.
- `404`: The standard error envelope.

---

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