---
title: "Search for a specific user"
method: GET
path: "/v1/users/lookup"
---

# Search for a specific user

`GET /v1/users/lookup`

## Query parameters

- `email` string
- `username` string
- `driver_company_id` string
- `phone` string

## Headers

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

## Response `200`

200

- object
  - `user` object
    - `id` integer
    - `email` unknown
    - `first_name` string
    - `last_name` string
    - `phone` string
    - `phone_ext` unknown
    - `time_zone` string
    - `metric_units` boolean
    - `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
    - `cycle` 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
    - `username` 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
    - `role` string
    - `status` string
    - `created_at` string
    - `updated_at` string
    - `external_ids` object[]

## Other responses

- `400` — 400

---

[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)