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

# List users

`GET /users`

Retrieve a paginated list of users with optional filtering.

**Filtering Options**:
- Organization membership
- User roles and permissions
- Geographic location/states
- Activity status
- Search by name or email

**Access Control**:
- Public: Basic user information only
- Authenticated: Organization members visible with more detail
- Admin: All users with full details

**Query Parameters**:
- `organization`: Filter by organization ID
- `roles`: Filter by user roles
- `search`: Search by name or email
- `states`: Filter by enabled states
- `is_active`: Filter by active status

## Query parameters

- `id` string
- `id__in` string
- `organization` string
- `organization__in` string
- `referring_user` string
- `referring_user__in` string
- `current_sign_in_at__gt` string
- `current_sign_in_at__lt` string
- `current_sign_in_at__lte` string
- `current_sign_in_at__gte` string
- `search` string
- `lineage` string
- `roles` string
- `role` string
- `has_team` string
- `no_team_incident` string
- `sort` 'created_at' | '-created_at' | 'updated_at' | '-updated_at'
- `recent_phone_users` string
- `team_ids` string
- `equipment` string
- `limit` integer
- `offset` integer

## Response `200`

OK

- object
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` UserBasic[], required
    - `id` integer
    - `first_name` string, required — User first name.
    - `last_name` string, required — User last name.
    - `referring_user` integer, nullable — User who referred this user.
    - `organization` integer, nullable — Organization to which the user belongs.
    - `files` FileJoin[]
      - `tag` string, nullable — User-generated tag(s) or desription.
      - `title` string, nullable — A user-generated title, such as exterior_front, exterior_rear, interior, basement, friends, headquarters, user manual, tornado path, furthest extent, etc. Note: file_files.title and location_locations.name are the default titles. However, this field allows the user to create their own title if it is shared. It may or may not be implemented.
      - `notes` string, nullable — Any user-specific notes, caption, or description for the file. Note: file_files.notes is the default captions. However, this field allows the user to create their own caption if they wish, e.g. if someone else shares it with them. It may or may not be implemented.
      - `created_at` string, date-time — Timestamp when the file was attached to the object.
      - `file_updated_at` string
      - `id` integer
      - `file` integer, nullable, required — The file.id of the file being attached to object_id.
      - `filename` string
      - `url` string
      - `full_url` string
      - `general_file_url` string
      - `blog_url` string
      - `large_blog_url` string
      - `large_thumbnail_url` string
      - `small_thumbnail_url` string
      - `filename_original` string
      - `file_type_t` string
      - `mime_content_type` string
      - `attr` string
      - `image_exif` string

---

[API](https://skmtc.dev/crisiscleanup/apis/crisiscleanup-api.md) · [All operations](https://skmtc.dev/crisiscleanup/apis/crisiscleanup-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/crisiscleanup/crisiscleanup-api/revisions/3fa73d4b2895/schema)