# Users

Part of the [Proof API](/api/proof/index.md). Host: `https://api.geodynamics.dev`.

The people in your environment who can be attached to a workplace group. Read-only over the public API.

Only active members are returned. Invited and deactivated memberships are left out, and so is the GeoDynamics support identity.

## GET /proof/v1/user/list

`https://api.geodynamics.dev/proof/v1/user/list`

Privilege required: `public:scope:user:read`

Get users

Returns a paged list of the active users in the key's environment, 100 per page.

Invited and deactivated memberships are left out, and so is the GeoDynamics support identity. What you get back is the set of people you can actually attach to a workplace group.

### Query parameters

| Name | Type | Required | Example |
| --- | --- | --- | --- |
| `page` Zero-based page index. Defaults to 0. | integer | optional | `0` |

### Responses

#### 200: OK

| Field | Type |
| --- | --- |
| `items` Users on this page. | array |
| `filter` Paging state for this query. | object |

```json
{
  "items": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "name": "John Doe",
      "email": "john.doe@example.com"
    }
  ],
  "filter": {
    "page": 0,
    "pageSize": 100,
    "totalCount": 1,
    "sortAscending": true,
    "sortString": "",
    "searchString": ""
  }
}
```

#### 401: Unauthorized. Missing or invalid service key.

#### 403: Forbidden. The key lacks the required scope.