---
title: "List users"
method: GET
path: "/users/"
tags: ["Organizations"]
---

# List users

`GET /users/`

## Request

- Base URL: `https://dashboard.hologram.io/api/1`
- URL: `https://dashboard.hologram.io/api/1/users/`
- Auth: one of:
  - HTTP basic
  - HTTP bearer
- TypeScript: <https://skmtc.dev/hologram/apis/hologram-rest-api-v1/docs/users/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `limit` integer
- `before` integer
- `after` integer
- `userid` integer

## Response `200`

OK

- UserListResponse
  - `success` boolean: Indicates whether the request was successful.
  - `limit` integer
  - `size` integer
  - `continues` boolean
  - `lastid` integer
  - `data` UserObject[]
    - `id` integer
    - `email` string, email
    - `first` string
    - `last` string
    - `role` string
    - `partnerid` integer
    - `registered` string, date-time
    - `is_verified` 0 | 1
    - `has_password` 0 | 1
    - `defaultaddressid` integer, nullable
    - `deleted` 0 | 1
    - `personal_org` integer, nullable: Personal organization ID; present on single-user responses
    - `impersonated_by` object, nullable: Present when the current session is being impersonated
    - `email_status` 'CONFIRM_PENDING': Present on update responses while an email change awaits confirmation
  - `links` PaginationLinks
    - `path` string: The API endpoint path
    - `base` string: The API base URL
    - `next` string: URL to retrieve the next page of results

## Other responses

- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/hologram/apis/hologram-rest-api-v1.md) - [All operations](https://skmtc.dev/hologram/apis/hologram-rest-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/hologram/apis/hologram-rest-api-v1/revisions/1bc07dcd1631?raw)