Find User by Email

GET /api/users/find-by-email

Returns the internal user ID, Uber ID, and Agency ID for the given email address.

Headers

Header	Required	Value
api-key	yes	Import API key

Query parameters

Parameter	Type	Required	Description
email	string	yes	Exact email address

Example request

GET /api/users/find-by-email?email=john.doe@example.com
api-key: <key>

Response

HTTP 200 OK

{
  "success": true,
  "user_id": 42,
  "uber_id": "abc123",
  "agency_id": null
}

Response fields

Field	Type	Description
user_id	int	Internal user ID
uber_id	string | null	The user’s Uber ID, or null
agency_id	string | null	The user’s agency identifier, or null

HTTP error codes

Status	Description
401	Missing api-key header
403	Invalid api-key value
404	No user with that email
422	Invalid email format