---
title: "List all the users of a company"
method: GET
path: "/v1/users"
---

# List all the users of a company

`GET /v1/users`

## Query parameters

- `role` string
- `duty_status` string
- `status` string
- `name` string
- `updated_after` string, date
- `per_page` integer
- `page_no` integer

## Headers

- `X-Time-Zone` string
- `X-Metric-Units` boolean
- `X-User-Id` integer

## Response `200`

200

- object
  - `users` object[]
    - `user` object
      - `id` integer
      - `email` unknown
      - `first_name` string
      - `last_name` string
      - `company_reference_id` string
      - `phone` string
      - `phone_ext` unknown
      - `time_zone` string
      - `carrier_name` string
      - `carrier_street` string
      - `carrier_city` string
      - `carrier_state` string
      - `carrier_zip` string
      - `violation_alerts` string
      - `terminal_street` string
      - `terminal_city` string
      - `terminal_state` string
      - `terminal_zip` string
      - `exception_24_hour_restart` boolean
      - `exception_8_hour_break` boolean
      - `exception_wait_time` boolean
      - `exception_short_haul` boolean
      - `exception_ca_farm_school_bus` boolean
      - `cycle2` unknown
      - `exception_24_hour_restart2` boolean
      - `exception_8_hour_break2` boolean
      - `exception_wait_time2` boolean
      - `exception_short_haul2` boolean
      - `exception_ca_farm_school_bus2` boolean
      - `export_combined` boolean
      - `export_recap` boolean
      - `export_odometers` boolean
      - `metric_units` boolean
      - `username` string
      - `cycle` string
      - `driver_company_id` unknown
      - `minute_logs` boolean
      - `duty_status` string
      - `eld_mode` string
      - `drivers_license_number` string
      - `drivers_license_state` string
      - `yard_moves_enabled` boolean
      - `personal_conveyance_enabled` boolean
      - `mobile_last_active_at` string
      - `mobile_current_sign_in_at` unknown
      - `mobile_last_sign_in_at` unknown
      - `web_last_active_at` string
      - `role` string
      - `status` string
      - `web_current_sign_in_at` unknown
      - `web_last_sign_in_at` unknown
      - `created_at` string
      - `updated_at` string
      - `external_ids` object[]
        - `external_id` string
        - `integration_name` string
  - `pagination` object
    - `per_page` integer
    - `page_no` integer
    - `total` integer

---

[API](https://skmtc.net/gomotive/apis/motive.md) · [All operations](https://skmtc.net/gomotive/apis/motive/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gomotive/motive/revisions/c71780e497f5/schema)