Skip to navigation

List customers

View as Markdown

Your customers, newest first, paginated (follow links.next).

Filters

  • email — exact match
  • phone — any format; (310) 555-0142, 3105550142 and +13105550142 all match
  • search — part of a first name, last name or email (2+ characters)
  • updated_since — ISO 8601; customers changed at or after this moment. Pair with the customer.updated webhook to keep a CRM in sync.
  • limit — page size, 1–500 (default 100)

bookings_count, total_spent_in_cents and last_trip_end count real trips only — not canceled bookings or abandoned checkouts.

Authentication

AuthorizationBearer

An API token from Settings → API tokens in Fleetwire, sent as Authorization: Bearer …. Each token carries scopes: read for every GET, plus write scopes such as bookings:write.

Query parameters

updated_sincedatetimeOptional
Only customers changed since this moment
emailstringOptional
Exact email
phonestringOptional
Phone in any format
searchstringOptional
Part of a name or email
limitintegerOptional1-500
Page size, max 500

Response

OK
datalist of objectsOptional
metaobjectOptional

Errors

401
Unauthorized Error
422
Unprocessable Entity Error
429
Too Many Requests Error