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

# List invitations that have not been accepted

> Open invitations your organisation has sent, newest first, and whether this deployment can send email. Owners and administrators, by console session.

Returns the invitations to your organisation that have not been accepted or withdrawn, newest first. An invitation whose link has expired stays in the list, marked `expired`, so you can send it again.

Accepted and withdrawn invitations are not listed: an accepted one is a [member](https://docs.mithunai.com/api-reference/members/list-members.md) now.

This endpoint takes a **signed-in console session**, not an API key: a request authenticated with an `mithunai_sk_` key is refused with `403`. It is a read, so it needs no `X-CSRF-Token` header.

You need the owner or admin role. The list is the addresses of people who are not members yet, so other roles cannot read it and receive `403`. No response from this endpoint ever contains an invitation link.

The list is a single page of at most 100 invitations; there is no cursor. See [Invitations](https://docs.mithunai.com/administration/invitations.md).

**limit** `integer` (default: 100)

How many invitations to return, from 1 to 100. A value outside that range returns `400`; it is not
clamped.

## Response

**data** `object[]` *required*

The open invitations, newest first.

**properties**

**id** `string` *required*

The invitation's ID (UUID).

**email** `string` *required*

The invited address.

**role** `string` *required*

`admin`, `editor`, `normal` or `dataset_operator`.

**status** `string` *required*

`pending` while the link works; `expired` once its seven days have passed.

**invited\_by\_name** `string | null` *required*

The display name of the member who sent it, or `null` if that account no longer exists.

**created\_at** `string` *required*

When it was first sent, ISO 8601 in UTC.

**expires\_at** `string` *required*

When the current link stops working, ISO 8601 in UTC.

**last\_sent\_at** `string` *required*

When it was last sent, ISO 8601 in UTC.

**mail\_configured** `boolean` *required*

Whether this deployment can send email. When `false`, sending an invitation returns `503`.

**limit** `object` *required*

**properties**

**max** `integer` *required*

The largest `limit` accepted, `100`.

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
# cookies.txt holds the cookies from your signed-in console session.
curl "$MITHUNAI_URL/mithunai/api/v1/invitations" --cookie cookies.txt
```

```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
import os
from http.cookiejar import MozillaCookieJar

import requests

jar = MozillaCookieJar("cookies.txt")
jar.load()

response = requests.get(
    f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/invitations", cookies=jar, timeout=30
)
response.raise_for_status()
print(response.json()["data"])
```

```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
// Runs in a page on the MITHUNAI console's own origin, while signed in.
const response = await fetch('/mithunai/api/v1/invitations', { credentials: 'include' })
console.log((await response.json()).data)
```

```json 200 theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "data": [
    {
      "id": "9d4e2a71-3c5b-4f80-a6d1-8e7b2c0f4a13",
      "email": "sarah.chen@example.com",
      "role": "editor",
      "status": "pending",
      "invited_by_name": "Alex Mercer",
      "created_at": "2026-10-13T09:12:05.640021+00:00",
      "expires_at": "2026-10-20T09:12:05.640021+00:00",
      "last_sent_at": "2026-10-13T09:12:05.640021+00:00"
    }
  ],
  "limit": { "max": 100 },
  "mail_configured": true
}
```

```json 403 theme={"theme":{"light":"github-light","dark":"github-dark"}}
{ "code": "authorization_error", "message": "You do not have permission to perform this action." }
```


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