---
title: "List Invites"
slug: "list-invites"
updated: 2026-06-08T12:46:40Z
published: 2026-06-08T12:46:40Z
---

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

# List Invites

Get/api/v1/listInvites

Lists all of the invites on the workspace.

[Permission](https://docs.rocket.chat/docs/permissions) required: `create-invite-links`

Responses200

OK

<select class='api-response-data' aria-label='Media type'><option value='916ac445-c67e-4abe-bcc7-ffd5668f4e35'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='caae15c0-644b-440d-86c1-9de730ffd833'>Success</option>
</select>Success

```json
[
  {
    "_id": "kDKQ3H",
    "days": 1,
    "maxUses": 1,
    "rid": "s7CE842q9WtvLctD7",
    "userId": "sNiDqHit5nGAGFg8X",
    "createdAt": "2019-12-20T03:31:56.774Z",
    "expires": "2019-12-21T03:31:56.774Z",
    "uses": 1,
    "_updatedAt": "2019-12-20T03:33:40.065Z"
  },
  {
    "_id": "99ScEP",
    "days": 1,
    "maxUses": 0,
    "rid": "s7CE842q9WtvLctD7",
    "userId": "sNiDqHit5nGAGFg8X",
    "createdAt": "2019-12-20T03:38:20.485Z",
    "expires": "2019-12-21T03:38:20.485Z",
    "uses": 0,
    "_updatedAt": "2019-12-20T03:38:20.485Z"
  },
  {
    "_id": "Y5JKM4",
    "days": 0,
    "maxUses": 1,
    "rid": "s7CE842q9WtvLctD7",
    "userId": "sNiDqHit5nGAGFg8X",
    "createdAt": "2019-12-20T03:38:25.313Z",
    "expires": null,
    "uses": 1,
    "_updatedAt": "2019-12-20T03:38:40.116Z"
  }
]
```

Array of object   object  _idstring    
daysinteger    
maxUsesinteger    
ridstring    
userIdstring    
createdAtstring    
expiresstring   | null  
usesinteger    
_updatedAtstring    

401

Unauthorized

<select class='api-response-data' aria-label='Media type'><option value='a3a55d59-d4eb-48aa-9e0c-ab6d16adf247'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='36014f66-9049-48a4-97cd-6cc151dd2e4a'>Authorization Error</option>
</select>Authorization Error

```json
{
  "status": "error",
  "message": "You must be logged in to do this."
}
```

object  statusstring    
messagestring