<commit_before># Users

These endpoints enable you to manage all the current users of your applications. You can retrieve their profile and edit or view their groups and their roles.

For more information, refer to [Auth0 Authorization Extension](/extensions/authorization-extension/v2#users).

## Get all Users

<h5 class="code-snippet-title">Examples</h5>

```http
GET https://{extension_url}/users
```

> RESPONSE SAMPLE:

```text
{
   "start":0,
   "limit":100,
   "length":5,
   "users":[
      {
         "logins_count":12,
         "identities":[
            {
               "isSocial":false,
               "user_id":"59091da1b3c34a15589c780d",
               "provider":"auth0",
               "connection":"Username-Password-Authentication"
            }
         ],
         "user_id":"auth0|59091da1b3c34a15589c780d",
         "last_login":"2017-06-25T07:28:54.719Z",
         "name":"<EMAIL>",
         "picture":"https://s.gravatar.com/avatar/your-gravatar.png",
         "email":"<EMAIL>"
      }
   ],
   "total":1
}
```

<%=
include('../../_includes/_http-method', {
  "http_badge": "badge-primary",
  "http_method": "GET",
  "path": '/users',
  "link": "#get-users"
}) %>

Use this endpoint to retrieve all users.

### Scopes

The [Access Token](#get-an-access-token) should have the following scopes:

<span class="badge">read:users</span>

### Parameters

| Parameter        | Description |
|:-----------------|:------------|
| `{extension_url}` <br/><span class="label label-danger">Required</span> | The URL of your Authorization Extension. For more info, see [Find your extension URL](#find-your-extension-url) |
| `{access_token}` <br/><span class="label label-danger">Required</span> | The token your client retrieved from Auth0 in order to access the API. For more info, see [Get an Access Token](#get-an-access-token) |

## Get a single User

<h5 class="code-snippet-title">Examples</h5>

```http
GET https://{extension_url}/users/{user_id}
```

> RESPONSE SAMPLE:

```text
{
   "email":"<EMAIL>",
   "email_verified":true,
   "user_id":"auth0|59091da1b3c34a15589c780d",
   "picture":"https://s.gravatar.com/avatar/your-gravatar.png",
   "nickname":"dummy.user",
   "identities":[
      {<commit_msg>Update _users.md<commit_after># Users

These endpoints enable you to manage all the current users of your applications. You can retrieve their profile and edit or view their groups and their roles.

For more information, refer to [Auth0 Authorization Extension](/extensions/authorization-extension/v2#users).

## Get all Users

<h5 class="code-snippet-title">Examples</h5>

```http
GET https://{extension_url}/users
```

> RESPONSE SAMPLE:

```text
{
   "start":0,
   "limit":100,
   "length":5,
   "users":[
      {
         "logins_count":12,
         "identities":[
            {
               "isSocial":false,
               "user_id":"59091da1b3c34a15589c780d",
               "provider":"auth0",
               "connection":"Username-Password-Authentication"
            }
         ],
         "user_id":"auth0|59091da1b3c34a15589c780d",
         "last_login":"2017-06-25T07:28:54.719Z",
         "name":"<EMAIL>",
         "picture":"https://s.gravatar.com/avatar/your-gravatar.png",
         "email":"<EMAIL>"
      }
   ],
   "total":1
}
```

<%=
include('../../_includes/_http-method', {
  "http_badge": "badge-primary",
  "http_method": "GET",
  "path": '/users',
  "link": "#get-users"
}) %>

Use this endpoint to retrieve all users.

### Scopes

The [Access Token](#get-an-access-token) should have the following scopes:

<span class="badge">read:users</span>

### Parameters

| Parameter        | Description |
|:-----------------|:------------|
| `{extension_url}` <br/><span class="label label-danger">Required</span> | The URL of your Authorization Extension. For more info, see [Find your extension URL](#find-your-extension-url) |
| `{access_token}` <br/><span class="label label-danger">Required</span> | The token your client retrieved from Auth0 in order to access the API. For more info, see [Get an Access Token](#get-an-access-token) |
| `{page}` | The page number. One based. |
| `{per_page}` | The amount of entries per page. Default: `100`. Max value: `200`. |

## Get a single User

<h5 class="code-snippet-title">Examples</h5>

```http
GET https://{extension_url}/users/{user_id}
```

> RESPONSE SAMPLE:

```text
{
   "email":"<EMAIL>",
   "email_verified":true,
   "user_id":"auth0|59091da1b3c34a15589c780d",
   "picture":"https://s.gravatar.com/avatar/your-gravatar.png",
   "nickname":"dummy.user",
   "identities":[
      {
{'fraction_non_alphanumeric': 0.1813821669936778, 'fraction_numerical': 0.038805319380858946, 'mean_word_length': 3.1861313868613137, 'pattern_counts': {'":': 52, '<': 35, '<?xml version=': 0, '>': 39, 'https://': 8, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1206960', 'n_tokens_mistral': 1636, 'n_tokens_neox': 1511, 'n_words': 329}