v1

latestOpenAPI 3.1.02026-07-2617501.1 MB

Search for a user (External ID)

get/v1/users/lookup_by_external_id

Query parameters

external_idstring required

Enter the external ID of the user that is used in an integration or a third-party software.

integration_namestring required

Enter the name of the integration to which the external ID belongs to.

idinteger required

The unique identifier assigned to the external ID.

Headers

X-Time-Zonestring

Specify the timezone for formatting the timestamps.

X-Metric-Unitsboolean

Specify if you want to use the Metric units or the Imperial units. TRUE: Metric units. FALSE: Imperial Units

X-User-Idstring

Specify the ID of the Fleet Admin or the Fleet Manager who is accessing this endpoint.

Response

200

Example response

{
  "user": {
    "id": 294979,
    "first_name": "John",
    "last_name": "Connor",
    "time_zone": "Pacific Time (US & Canada)",
    "carrier_name": "Demo Carrier",
    "carrier_street": "415 Truckin St.",
    "carrier_city": "San Francisco",
    "carrier_state": "CA",
    "carrier_zip": "94105",
    "violation_alerts": "1_hour",
    "terminal_street": "350 Sansome St",
    "terminal_city": "San Francisco",
    "terminal_state": "CA",
    "terminal_zip": "94104",
    "cycle": "70_8",
    "export_combined": true,
    "export_recap": true,
    "export_odometers": true,
    "username": "demo_driver_1_kt3647454",
    "minute_logs": true,
    "duty_status": "off_duty",
    "eld_mode": "logs",
    "yard_moves_enabled": true,
    "personal_conveyance_enabled": true,
    "role": "driver",
    "status": "active",
    "created_at": "2016-08-09T00:43:40Z",
    "updated_at": "2017-04-20T21:08:32.134197Z"
  }
}