Skip to navigation
API ReferenceUtilities

List Utilities

Retrieve a paginated list of utilities.

Supports:

  • Pagination (page_size, page)
  • Sorting by name (order_by, default: asc)
  • Search by name, holding company, or state code (q)
  • Filter by state (two-letter code) and ownership_type
  • Geo mode: pass lat+lng (together) to return every utility whose service territory covers the point, ordered most-specific-first. Name/state/ownership_type filters are ignored, and an empty array is returned if none cover the point.

Only active utilities are returned. Utilities are seeded globally from the HIFLD catalog. Most fields are read-only; only custom fields can be updated (see PATCH /utilities/{utility_id}).

Authentication

x-api-keystring
API Key authentication via header

Query parameters

page_sizeintegerOptional1-100Defaults to 20

Number of items per page (max 100)

pageintegerOptional>=1Defaults to 1

Page number (1-based)

qstringOptional

Search by utility name, holding company, or state code (case-insensitive).

statestringOptional=2 characters

Filter by two-letter state code (e.g. “CA”).

ownership_typeenumOptional
Filter by ownership type.
order_byenumOptionalDefaults to asc
Sort order for results
Allowed values:
latdoubleOptional-90-90

Latitude in decimal degrees. Must be used together with lng.

lngdoubleOptional-180-180

Longitude in decimal degrees. Must be used together with lat.

Response

List of utilities
idintegerOptional
Unique identifier.
namestringOptional
Utility name.
statestring or nullOptional

Two-letter state code (e.g. “CA”).

stateNamestring or nullOptional

Full state name (e.g. “California”).

ownershipTypeenum or nullOptional
holdingCompanystring or nullOptional
addressstring or nullOptional
phonestring or nullOptional
websitestring or nullOptional
hoursOfOperationstring or nullOptional
isActivebooleanOptional
Whether this utility is currently active in the catalog.
createdAtstringOptionalformat: "date-time"
updatedAtstringOptionalformat: "date-time"
custommap from strings to anyOptional

Custom field values keyed by property keyName. This includes only customer-defined custom columns (see GET /properties?record_type=utility). Built-in catalog utility fields (name, state, ownershipType, holdingCompany, etc.) are exposed as top-level fields on the utility object and are read-only.

Errors

400
Bad Request Error
401
Unauthorized Error
502
Bad Gateway Error