> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nekt.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Invitations

> The organization's invitations still waiting on a reply.

Returns the organization's invitations that are still outstanding: not yet accepted, not revoked, and (for an expired one) still the most recent invitation sent to that address.

Once somebody accepts, they stop being an invitation and become a member, so they drop off this list. To see them after that, read the member list in the app under [Members](https://docs.nekt.com/organizations/members.md).

> [!NOTE]
>
> One row per address. Resending does not create a second invitation, so an address you have chased three times still appears once, with the latest `expires_at`.

## Response

An array of [organization invitation objects](https://docs.nekt.com/platform-api/invitations/organization/invitation.md). This endpoint is not paginated.

```json theme={null}
[
  {
    "id": "c1f0a9d4-5b62-4e18-9a73-2d8e4f6b0c51",
    "email": "analyst@example.com",
    "first_name": "",
    "last_name": "",
    "organization_role": "member",
    "sent_at": "2026-09-24T10:14:02Z",
    "expires_at": "2026-10-01T10:14:02Z",
    "accepted_at": null,
    "revoked_at": null,
    "created_at": "2026-09-24T10:14:02Z",
    "created_by": 12,
    "user": 48,
    "workspace": null
  }
]
```

| Field | Description |
| - | - |
| `organization_role` | The role in the organization the invitation grants. |
| `created_by` | The id of the user who sent the invitation. |
| `user` | The id of the pending user the invitation created. Use it as a grant or group target. |
| `workspace` | The workspace the invitation was issued in, for one sent through [Invite to Workspace](https://docs.nekt.com/platform-api/invitations/workspace/invite.md). `null` for an invitation sent to the organization. |

## Expanding related objects

`created_by`, `user`, and `workspace` are ids by default. Pass `expand[]` to get the objects instead. `expand[]=workspace_memberships` adds the workspaces the invitee is already in, with their role in each.

```bash theme={null}
curl --request GET \
  --url "https://api.nekt.ai/api/v1/organization/invitations/?expand[]=user&expand[]=workspace_memberships" \
  --header "x-api-key: YOUR_API_KEY"
```

See [Expanding Responses](https://docs.nekt.com/platform-api/expanding-responses.md).

## Find what has gone stale

An expired invitation still holds every workspace, group, and grant attached to it: the link stopped working, the access did not. Resending re-opens it without re-granting anything.

```python theme={null}
from datetime import datetime, timezone

import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.nekt.ai"

headers = {"x-api-key": API_KEY, "Content-Type": "application/json"}
now = datetime.now(timezone.utc)

invitations = requests.get(f"{BASE_URL}/api/v1/organization/invitations/", headers=headers).json()

for invitation in invitations:
    expires_at = datetime.fromisoformat(invitation["expires_at"].replace("Z", "+00:00"))
    if expires_at < now:
        print(f"{invitation['email']} expired on {expires_at:%Y-%m-%d} - resending")
        requests.post(
            f"{BASE_URL}/api/v1/organization/invitations/",
            headers=headers,
            json={"email": invitation["email"], "organization_role": invitation["organization_role"]},
        )
```

## Related

* [Invite User](https://docs.nekt.com/platform-api/invitations/organization/invite.md): inviting and resending.
* [List Workspace Invitations](https://docs.nekt.com/platform-api/invitations/workspace/list.md): only the invitations waiting in your current workspace.
* [Revoke an Invitation](https://docs.nekt.com/platform-api/invitations/organization/revoke.md): for the ones that are never coming.


## OpenAPI

````yaml GET /api/v1/organization/invitations/
openapi: 3.0.3
info:
  title: Nekt API
  version: v1
  description: Nekt API Documentation
  contact:
    email: support@nekt.ai
servers:
  - url: https://api.nekt.ai
security: []
paths:
  /api/v1/organization/invitations/:
    get:
      tags:
        - v1
      description: >-
        The organization's invitations. Each names the user it created, pending
        in the organization

        until they accept, and the workspace it was issued in (null for an
        invitation to the

        organization). `created_by`, `user` and `workspace` are ids;
        `expand[]=created_by`,

        `expand[]=user` and `expand[]=workspace` return the objects. Inviting
        can also place the invitee

        in workspaces right away (`workspaces`), each at a role; the invitation
        still belongs to the

        organization.
      operationId: v1_organization_invitations_list
      responses:
        '200':
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/OrganizationInvitation'
          description: ''
      security:
        - ApiKeyAuth: []
components:
  schemas:
    OrganizationInvitation:
      type: object
      description: >-
        An invitation as `organization/invitations/` answers it:
        `invitations/`'s fields, plus the user

        it created (pending in the organization until they accept) and the
        workspace it was issued in

        (a workspace invitation, specs/workspaces.md §4.9a; null for an
        organization one). `created_by`,

        `user` and `workspace` are ids, each expandable. `organization_role` is
        the role in the organization

        the invitation grants, `invitations/`'s `role`.
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
        first_name:
          type: string
          maxLength: 150
        last_name:
          type: string
          maxLength: 150
        email:
          type: string
          format: email
          title: Email address
          maxLength: 254
        organization_role:
          allOf:
            - $ref: '#/components/schemas/OrganizationRoleEnum'
          default: member
          description: >-
            The invitee's role in the organization. Defaults to `member`. You
            cannot invite somebody to a role above your own, and on the Free
            plan only owners can be invited.


            * `owner` - Owner

            * `admin` - Admin

            * `member` - Member
        functional_area:
          nullable: true
          oneOf:
            - $ref: '#/components/schemas/FunctionalAreaEnum'
            - $ref: '#/components/schemas/BlankEnum'
            - $ref: '#/components/schemas/NullEnum'
        other_functional_area:
          type: string
          nullable: true
          maxLength: 128
        sent_at:
          type: string
          format: date-time
          readOnly: true
        expires_at:
          type: string
          format: date-time
          readOnly: true
        accepted_at:
          type: string
          format: date-time
          readOnly: true
          nullable: true
        revoked_at:
          type: string
          format: date-time
          readOnly: true
          nullable: true
        created_at:
          type: string
          format: date-time
          readOnly: true
        created_by:
          type: integer
          readOnly: true
          description: The user who sent the invitation. (Expandable)
        user:
          type: integer
          nullable: true
          readOnly: true
          description: >-
            The user the invitation created, pending in the organization until
            they accept. (Expandable)
        workspace:
          type: string
          format: uuid
          nullable: true
          readOnly: true
          description: >-
            The workspace the invitation was issued in; null for an organization
            invitation. (Expandable)
        workspaces:
          type: array
          items:
            $ref: '#/components/schemas/OrganizationInvitationWorkspace'
          writeOnly: true
          description: >-
            Workspaces to place the invitee in right away, each with their role
            there; the invitation still belongs to the organization. An owner or
            admin is an admin of every workspace: omit `workspaces` for them, or
            list every workspace as admin. No workspace twice.
      required:
        - accepted_at
        - created_at
        - created_by
        - email
        - expires_at
        - id
        - revoked_at
        - sent_at
        - user
        - workspace
    OrganizationRoleEnum:
      enum:
        - owner
        - admin
        - member
      type: string
      description: |-
        * `owner` - Owner
        * `admin` - Admin
        * `member` - Member
    FunctionalAreaEnum:
      enum:
        - data_analytics
        - sales
        - customer_support
        - operations
        - marketing
        - finance
        - product_development
        - growth
        - executive_leadership
        - other
      type: string
      description: |-
        * `data_analytics` - Data & Analytics
        * `sales` - Sales
        * `customer_support` - Customer Support
        * `operations` - Operations
        * `marketing` - Marketing
        * `finance` - Finance
        * `product_development` - Product Development
        * `growth` - Growth
        * `executive_leadership` - Executive Leadership
        * `other` - Other
    BlankEnum:
      enum:
        - ''
    NullEnum:
      enum:
        - null
    OrganizationInvitationWorkspace:
      type: object
      description: >-
        One workspace an organization invitation places its invitee in, with
        their role there.
      properties:
        workspace:
          type: string
          format: uuid
          description: A workspace of your organization.
        role:
          allOf:
            - $ref: '#/components/schemas/WorkspaceRoleEnum'
          description: |-
            The invitee's role in `workspace`.

            * `admin` - Admin
            * `member` - Member
      required:
        - role
        - workspace
    WorkspaceRoleEnum:
      enum:
        - admin
        - member
      type: string
      description: |-
        * `admin` - Admin
        * `member` - Member
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: 'API Key authentication. Format: ''x-api-key: api_key'''

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.