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

# List users

`GET /api/v1/users`

Returns a paginated list of users in your organization.

## Query parameters

- `limit` integer
- `cursor` string
- `status` 'onboarding_provisioning_planned' | 'onboarding' | 'active' | 'inactive' | 'offboarding_planned' | 'offboarding' | 'offboarded' | 'all'

## Response `200`

User list

- UserList — Paginated list of users
  - `data` User[], required — List of users
    - `deactivated_at` string, date-time, nullable — Deactivation timestamp
    - `departments` string[] — Departments the user belongs to
    - `email` string, email, required — Email address
    - `employment_type` 'full_time' | 'part_time' | 'contract' | 'freelance' | 'internship' | 'apprenticeship' | 'working_student' | 'training', nullable — Employment type
    - `first_name` string, required — First name
    - `full_name` string — Full name (computed)
    - `id` string, uuid, required — User ID
    - `inserted_at` string, date-time — Creation timestamp
    - `job_title` string, nullable — Job title
    - `last_name` string, required — Last name
    - `location_city` string, nullable — City location
    - `manager_user_id` string, uuid, nullable — Manager user ID
    - `status` 'active' | 'inactive' | 'onboarding' | 'onboarding_provisioning_planned' | 'offboarding' | 'offboarding_planned' | 'offboarded', required — Current status
    - `teams` string[] — Teams the user belongs to
    - `updated_at` string, date-time — Last update timestamp
  - `meta` PaginationMeta, required — Pagination metadata
    - `page` integer, required — Current page number
    - `page_size` integer, required — Items per page
    - `total_count` integer, required — Total number of items
    - `total_pages` integer, required — Total number of pages

## Other responses

- `400` — Bad request
- `401` — Unauthorized

---

[API](https://skmtc.net/accessowl/apis/accessowl-api.md) · [All operations](https://skmtc.net/accessowl/apis/accessowl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/accessowl/accessowl-api/versions/f01f507d4b4e/schema)