MEmeterplan
data-feed

Texas TDU Lookup by ZIP

Changed on

Resolve any Texas residential ZIP code to its Transmission and Distribution Utility (TDU): Oncor, CenterPoint, AEP Texas Central, AEP Texas North, TNMP, or Lubbock Power & Light. Returns the canonical utility code, full display name, short name, and whether the ZIP is in a deregulated retail electric market. Backed by Light API's eligibility check (private API made public via this tool).

A primitive utility-lookup tool. Useful as a building block for any agent or app that needs to know which TDU serves a Texas ZIP — TDU determines which retail electric providers are available, what delivery rates apply, and whether the customer can switch providers.

Texas has 6 TDUs serving the deregulated retail market:

  • Oncor Electric Delivery (DFW + much of north/central Texas)
  • CenterPoint Energy (Houston + southeast Texas)
  • AEP Texas Central (south Texas, including Corpus Christi)
  • AEP Texas North (Abilene + west-central Texas)
  • Texas-New Mexico Power Company / TNMP (scattered pockets)
  • Lubbock Power & Light (Lubbock — recently joined deregulated market)

Returns null for ZIPs that aren't in the deregulated market (e.g., Austin Energy / CPS / municipal utilities — these markets don't offer retail provider choice).

Why this tool exists: Light API's eligibility endpoint isn't publicly accessible. This tool wraps it as a stable, public primitive so any agent can resolve TDU without needing Light credentials.

post/api/v1/get-utility-for-zip

Request

Request body

zipCodestring required

5-digit Texas ZIP code. Examples: '75201' (Dallas), '77002' (Houston), '78401' (Corpus Christi), '76901' (Abilene), '79401' (Lubbock).

Response

Tool ran successfully.

zipCodestring required

The ZIP code that was looked up.

utilityCodestring required

Canonical TDU code. One of: 'ONCOR', 'CNP' (CenterPoint), 'AEP_CENTRAL', 'AEP_NORTH', 'TNMP', 'LPPL' (Lubbock Power & Light).

utilityDisplayNamestring required

Full TDU name as the utility presents it. Examples: 'Oncor Electric Delivery', 'CenterPoint Energy', 'Texas-New Mexico Power Company'.

utilityShortNamestring required

Common short name. Examples: 'Oncor', 'CenterPoint', 'AEP Central'.

isDeregulatedboolean required

True if the ZIP is in the Texas deregulated retail electric market (where customers can choose a retail provider). False for municipal utility territories (Austin Energy, CPS, etc.).

eligibilityLikelihoodnumber required

Light API's confidence (0-1) that this ZIP can be served by a retail provider. Useful for spotting edge cases like new construction or address ambiguity.

resolvedboolean required

True if Light API returned a confident answer. False if we fell back to the default (ONCOR) due to API unavailability or unknown ZIP.

Changes

  • 2b73e36f9afdRevision changes
    • warning

      added the new tool_error enum value to the response property for the response status

    • warning

      added the new tool_error enum value to the response property for the response status

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status