---
title: "List user invitations"
source_url: https://dev.digicert.com/certcentral-apis/services-api/users/list-user-invitations.html
api_method: GET
api_endpoint: "/services/v2/user/invite"
api_url: "https://www.digicert.com/services/v2/user/invite"
---

**GET** `https://www.digicert.com/services/v2/user/invite`

Use this endpoint to retrieve user invitations, including invitations that are awaiting or require administrator approval. Use the invitation ID from the response to approve an invitation. 


> **Info**
>
> Include `accepted` in the `filters[status]` value to return invitations created through DigiCert ONE Login. Without this value, the response can include the number of invitations in `page.total` without including the corresponding invitation information in the `invites` array.


## Example requests and responses

**cURL**

```bash
curl --globoff --request GET \
  --url 'https://www.digicert.com/services/v2/user/invite?limit=25&offset=0&filters[status][0]=pending&filters[status][1]=accepted&content_type=json' \
  --header 'X-DC-DEVKEY: {{api_key}}'
```


## 200 OK

```json
{
  "invites": [
    {
      "id": 66374958,
      "date_created": "2025-12-10T22:38:37+00:00",
      "date_accepted": "2025-12-10T22:38:37+00:00",
      "last_sent_date": "2025-12-10T22:38:37+00:00",
      "status": "accepted",
      "email": "john.doe@email.com",
      "container_id": 92231,
      "user": {
        "id": 179414,
        "first_name": "John",
        "last_name": "Doe"
      },
      "requested_user": {
        "email": "john.doe@email.com"
      }
    }
  ],
  "page": {
    "total": 1
  }
}
```

## Filters and URL query parameters

This endpoint supports filtering by invitation status. To provide multiple status values, use a zero-based index for each value, such as `filters[status][0]=pending&filters[status][1]=accepted`.

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>filters[status][<code>{{index}}</code>]</td>
<td>optional</td>
<td>string</td>
<td>Filters results by invitation status. Use <code>pending</code> to retrieve pending invitations and <code>accepted</code> to retrieve invitations generated through DigiCert ONE Login.<br>Allowed values: accepted, expired, or cancelled.
</td>
</tr>
<tr>
<td>offset</td>
<td>optional</td>
<td>int</td>
<td>Zero-based index of the first invitation to include in the response.<br>Example: <code>0</code></td>
</tr>
<tr>
<td>limit</td>
<td>optional</td>
<td>int</td>
<td>Maximum number of invitations to include in the response.<br>Example: <code>25</code></td>
</tr>
<tr>
<td>content_type</td>
<td>optional</td>
<td>string</td>
<td>Response format.<br>Allowed value: <code>json</code></td>
</tr>
</tbody>
</table>

## Request parameters

This endpoint does not accept a request body.

## Response parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>invites</td>
<td>array of objects</td>
<td>User invitations that match the request filters. This array can be omitted when DigiCert ONE Login invitations are counted in <code>page.total</code> but <code>accepted</code> is not included in the status filter.</td>
</tr>
<tr>
<td>.. id</td>
<td>int</td>
<td>Invitation ID. Use this value as the <code>invitation_id</code> path parameter when approving the invitation.</td>
</tr>
<tr>
<td>.. date_created</td>
<td>string</td>
<td>Date and time the invitation was created.<br>Format: UTC timezone and ISO 8601 date</td>
</tr>
<tr>
<td>.. date_accepted</td>
<td>string</td>
<td>Date and time the invitation was accepted. For an invitation that has not been accepted, this value can be <code>null</code>.<br>Format: UTC timezone and ISO 8601 date</td>
</tr>
<tr>
<td>.. last_sent_date</td>
<td>string</td>
<td>Date and time the invitation was most recently sent.<br>Format: UTC timezone and ISO 8601 date</td>
</tr>
<tr>
<td>.. status</td>
<td>string</td>
<td>Current invitation status. Values are <code>pending</code> and <code>accepted</code>.</td>
</tr>
<tr>
<td>.. email</td>
<td>string</td>
<td>Email address associated with the invitation.</td>
</tr>
<tr>
<td>.. container_id</td>
<td>int</td>
<td>ID of the container (division) associated with the invitation.</td>
</tr>
<tr>
<td>.. user</td>
<td>object</td>
<td>Details about the user associated with the invitation.</td>
</tr>
<tr>
<td>.. .. id</td>
<td>int</td>
<td>User ID.</td>
</tr>
<tr>
<td>.. .. first_name</td>
<td>string</td>
<td>User's first name.</td>
</tr>
<tr>
<td>.. .. last_name</td>
<td>string</td>
<td>User's last name.</td>
</tr>
<tr>
<td>.. requested_user</td>
<td>object</td>
<td>User information submitted with the invitation request.</td>
</tr>
<tr>
<td>.. .. email</td>
<td>string</td>
<td>Email address submitted for the requested user.</td>
</tr>
<tr>
<td>page</td>
<td>object</td>
<td>Details about the paginated results. For more information, see <a href="https://dev.digicert.com/md/certcentral-apis/services-api/structures.md#page-details-object">Page details object</a>.</td>
</tr>
<tr>
<td>.. total</td>
<td>int</td>
<td>Total number of invitations that match the request filters.</td>
</tr>
</tbody>
</table>