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
idinteger
Unique identifier.
namestring
Utility name.
statestring or null

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

stateNamestring or null

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

ownershipTypeenum or null
holdingCompanystring or null
addressstring or null
phonestring or null
websitestring or null
hoursOfOperationstring or null
isActiveboolean
Whether this utility is currently active in the catalog.
createdAtstringformat: "date-time"
updatedAtstringformat: "date-time"
custommap from strings to any

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