utilities

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}).

get/utilities

Request

  • Base URL: https://api.coperniq.io/v1
  • URL: https://api.coperniq.io/v1/utilities
  • Auth: API key in header x-api-key

Query parameters

page_sizeinteger

Number of items per page (max 100)

pageinteger

Page number (1-based)

qstring

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

statestring

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

ownership_type'INVESTOR' | 'MUNICIPAL' | 'MUNICIPAL_MARKETING_AUTHORITY' | 'COOPERATIVE' | 'FEDERAL' | 'STATE' | 'POLITICAL' | 'COMMUNITY_CHOICE_AGGREGATOR' | 'WHOLESALE_POWER_MARKETER' | 'OTHER'

Filter by ownership type.

order_by'asc' | 'desc'

Sort order for results

latnumber double

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

lngnumber double

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

Response

List of utilities

idinteger

Unique identifier.

namestring

Utility name.

statestring nullable

Two-letter state code (e.g. "CA").

stateNamestring nullable

Full state name (e.g. "California").

ownershipType'INVESTOR' | 'MUNICIPAL' | 'MUNICIPAL_MARKETING_AUTHORITY' | 'COOPERATIVE' | 'FEDERAL' | 'STATE' | 'POLITICAL' | 'COMMUNITY_CHOICE_AGGREGATOR' | 'WHOLESALE_POWER_MARKETER' | 'OTHER'
holdingCompanystring nullable
addressstring nullable
phonestring nullable
websitestring nullable
hoursOfOperationstring nullable
isActiveboolean

Whether this utility is currently active in the catalog.

createdAtstring date-time
updatedAtstring date-time
customobject

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.

Changes

No recorded changes to this operation across all 1 revision of this API.