# List pending invites

`GET https://api.mothership.com/beta/users/invites`

Sandbox: `https://sandbox.api.mothership.com/beta/users/invites`

Lists your organization's pending invites, newest first: people who were invited and haven't joined yet. Requires the `organization:user.read` permission.

## Authorization

Send your API token as a Bearer token: `Authorization: Bearer <token>`.

## Query parameters

- `page` (integer, optional, default 1, min 1): Page to return, starting at 1.
- `perPage` (integer, optional, default 25, min 1, max 100): Maximum number of pending invites returned for each page.

## Responses

### 200

The page of invites is wrapped inside an object named "data"

- `data` (object, required)
  - `results` (array of objects, required)
    - `id` (string, required): ID of the invite.
    - `email` (string, required): Email address the invite was sent to.
    - `firstName` (string, required)
    - `lastName` (string, required, nullable)
    - `role` (string, required): Role the person gets once they accept the invite. `manager`: Manage all features for your organization. `shipper`: Book shipments. Read-access to other features. `accountant`: Manage and edit billing. View-only for other features. `viewer`: View-only account access. Nobody is invited as an owner. One of: `manager`, `shipper`, `accountant`, `viewer`.
    - `createdAt` (string<date-time>, required): When the invite was sent.
    - `expiresAt` (string<date-time>, required): When the invite link stops working.
    - `expired` (boolean, required): True when the invite link has expired. The person can't accept it; revoke it and invite them again.
  - `page` (integer, required, min 1): Current page of pending invites.
  - `perPage` (integer, required, min 1): Maximum number of pending invites returned for each page.
  - `total` (integer, required, min 0): Number of pending invites across every page.
  - `hasMore` (boolean, required): True if more pending invites can be fetched from a subsequent page.

## Example request

```bash
curl --request GET \
  --url 'https://sandbox.api.mothership.com/beta/users/invites' \
  --header "Authorization: Bearer $MOTHERSHIP_API_TOKEN" \
  --header 'Accept: application/json'
```

## Example response (200)

```json
{
  "data": {
    "results": [
      {
        "id": "3f1c2a9e-5b7d-4e8a-9c61-2d4f8b0e7a15",
        "email": "logistics@example.com",
        "firstName": "Dana",
        "lastName": "Reyes",
        "role": "manager",
        "createdAt": "2026-03-19T17:00:00.000Z",
        "expiresAt": "2026-03-19T17:00:00.000Z",
        "expired": true
      }
    ],
    "page": 1,
    "perPage": 25,
    "total": 1,
    "hasMore": true
  }
}
```