Skip to content

Add utility lookup by EIA ID#224

Merged
texture-fleet-agent[bot] merged 1 commit intomainfrom
meridian/utilities-by-eia-id-route-v3
May 8, 2026
Merged

Add utility lookup by EIA ID#224
texture-fleet-agent[bot] merged 1 commit intomainfrom
meridian/utilities-by-eia-id-route-v3

Conversation

@texture-coding-agent
Copy link
Copy Markdown
Contributor

Summary

Adds a public utility-detail lookup route by EIA Utility ID:

GET /api/v1/utilities/by-eia-id/{eiaId}

Sibling to the existing slug-based route. Useful for consumers that exchange canonical EIA Utility IDs rather than CommonGrid slugs.

Details

  • Mirrors the existing GET /api/v1/utilities/{slug} response shape
  • Supports the same ?include=iso,rto,ba and ?fields= sparse-fieldset semantics
  • Excludes soft-deleted utilities
  • Returns normal public API 404 for unknown EIA IDs
  • Adds shared edge cache headers to utility detail responses:
    • Cache-Control: public, s-maxage=3600, stale-while-revalidate=86400

Validation

  • npm run build ✅ — route registers as /api/v1/utilities/by-eia-id/[eiaId]

Adds GET /api/v1/utilities/by-eia-id/{eiaId}, a sibling to the existing
slug-based detail route for consumers that hold canonical EIA Utility IDs.

The new route mirrors the slug route response shape and supports the same
?include=iso,rto,ba and ?fields sparse-fieldset semantics. It excludes
soft-deleted utilities and returns 404 when no matching EIA ID exists.

Also adds shared edge caching headers on utility detail responses:
public, s-maxage=3600, stale-while-revalidate=86400.

Validation: npm run build registers /api/v1/utilities/by-eia-id/[eiaId].
@vercel
Copy link
Copy Markdown

vercel Bot commented May 8, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
commongrid Ready Ready Preview, Comment May 8, 2026 3:16pm

Request Review

@texture-fleet-agent texture-fleet-agent Bot merged commit 9444d38 into main May 8, 2026
6 of 7 checks passed
@texture-fleet-agent texture-fleet-agent Bot deleted the meridian/utilities-by-eia-id-route-v3 branch May 8, 2026 15:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant