{"contractVersion":"parcelops.connector.v1","name":"phmsa","displayName":"PHMSA Pipeline Safety & NPMS County Mileage","description":"County-level pipeline mileage and LNG plant counts from the PHMSA National Pipeline Mapping System, pipeline operator contacts, point-radius transmission pipeline geometry from EIA, and PHMSA pipeline enforcement case history. Covers what runs through a parcel's county, who operates it, and how that operator has been cited. Pipeline incident and accident data are NOT available: PHMSA publishes them only on hosts that are unreachable or login-gated for a server, and this connector states that absence rather than approximating it.","tags":["phmsa","npms","pipelines","pipeline-safety","lng","natural-gas","hazardous-liquid","easement","county","enforcement","operators","datacenter-siting"],"authentication":{"type":"none","required":false},"provenance":{"sourceName":"PHMSA National Pipeline Mapping System and PHMSA Pipeline Enforcement (PRIMIS)","sourceUrl":"https://www.npms.phmsa.dot.gov/Documents/NPMS_Active_Pipe_County_Mileage.xlsx","apiBaseUrl":"https://www.npms.phmsa.dot.gov/","documentationUrl":"https://www.npms.phmsa.dot.gov/GeneralPublic.aspx"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P1Y","updatedAtField":"asOf","notes":"NPMS operator submissions are due March 15 (gas and LNG) and June 15 (hazardous liquid); the summary workbooks are regenerated irregularly and each carries its own vintage. The enforcement file refreshes roughly monthly."}},"coverage":{"geographic":{"status":"declared","value":["United States counties and county equivalents, keyed by five-digit FIPS (3,227 counties in the NPMS mileage workbook)","United States counties with at least one active NPMS LNG plant (126 counties)","United States interstate and intrastate natural gas transmission pipeline centerlines (EIA, 32,892 features)","United States pipeline operators with PHMSA enforcement history since 2002 (778 operators, 5,073 cases)"]},"temporal":{"status":"declared","value":{"start":"2002","notes":"Enforcement cases run 2002 forward. The mileage and LNG workbooks are point-in-time snapshots with separate vintages that are typically several months to a year apart."}}},"methods":{"total":5,"items":[{"name":"getCountyPipelineCoverage","description":"Active gas transmission and hazardous liquid pipeline miles in one county, with operator contacts.","notes":"Pass countyFips, or stateAlpha plus countyName. Zero miles is a published zero.","inputSchema":{"type":"object","properties":{"countyFips":{"type":"string","pattern":"^\\d{3,5}$","description":"Five-digit state + county FIPS such as 48201 (Harris County, Texas). A three-digit county needs stateAlpha."},"stateAlpha":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Two-letter state, district, or territory code. Required with countyName."},"countyName":{"type":"string","minLength":2,"maxLength":80,"description":"Published county name such as \"Harris County\". Use with stateAlpha."},"includeOperators":{"type":"boolean","description":"Include the operator by commodity breakdown. Defaults to true."},"limit":{"type":"integer","minimum":1,"maximum":200,"description":"Operator rows to return. Defaults to 50; Harris County TX has 156."}},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P1Y","updatedAtField":"asOf","notes":"NPMS operator submissions are due March 15 (gas and LNG) and June 15 (hazardous liquid); the summary workbook is regenerated irregularly."},"scope":"method"},"entities":{"status":"declared","value":["county","pipeline_operator"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"declared","value":{"mileage":"miles"}},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["All NPMS data is for reference purposes only. It should never be used as a substitute for contacting a one-call center prior to excavation activities. Please call 811 before any digging occurs.","County totals are not parcel-level facts. A county carrying hundreds of miles may have nothing within twenty miles of a given parcel, and a county carrying zero may still have gathering lines, distribution mains, or service lines.","NPMS counts only hazardous liquid and gas transmission pipelines categorized as Active. Gathering lines, distribution mains, service lines, and Permanently Abandoned pipelines are excluded.","PHMSA restricts NPMS pipeline GIS data to federal, tribal, state, and local government agencies and to operators’ own lines. This connector reads only the publicly published county summary workbooks and public operator contact directory, never the NPMS Public Viewer, PIMMA, or third-party republications of NPMS geospatial data.","The point-radius pipeline geometry read queries an EIA-sourced transmission centerline layer hosted by the Esri Federal User Community under the Esri Master License Agreement. That hosted layer is not public domain, unlike the two PHMSA files.","The EIA pipeline layer is stale and coarse: operator values are unreconciled free text that still names companies dissolved decades ago (for example \"Amoco Pipeline Co\"), it carries transmission trunk lines only, and it holds no PHMSA operator id. A zero result never means no pipeline is near the property.","Pipeline incident and accident records are NOT available through this connector. PHMSA publishes them only on www.phmsa.dot.gov (HTTP 403 to every server-side client), inside the session-gated NPMS Public Viewer, and behind the portalpublic.phmsa.dot.gov login.","The workbook OPID and the enforcement file Operator_ID are the same PHMSA identifier space and join cleanly. The EIA layer’s Operator string does not and must never be fuzzy-matched into an operator id.","An enforcement case is an administrative action against an operator, not a finding about any parcel, address, or pipeline segment. An open case is an allegation rather than an adjudicated violation.","Penalty amounts are frequently empty upstream and are returned as null, never as 0. An unpenalized Warning Letter is not a zero-dollar penalty.","County-total mileage is not parcel grain. 398 of 3,227 counties report zero, which is a citable negative for the NPMS scope and never a clearance to excavate."]},{"name":"getCountyLngPlants","description":"Count of active NPMS LNG plants in one county, with the operators running them.","notes":"A county absent from the file returns plantCount 0, not an error.","inputSchema":{"type":"object","properties":{"countyFips":{"type":"string","pattern":"^\\d{3,5}$","description":"Five-digit state + county FIPS such as 48201 (Harris County, Texas). A three-digit county needs stateAlpha."},"stateAlpha":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Two-letter state, district, or territory code. Required with countyName."},"countyName":{"type":"string","minLength":2,"maxLength":80,"description":"Published county name such as \"Harris County\". Use with stateAlpha."},"includeOperators":{"type":"boolean","description":"Include the operator breakdown. Defaults to true."}},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P1Y","updatedAtField":"asOf","notes":"Regenerated on its own schedule, typically many months apart from the mileage workbook. Never share one asOf across the two."},"scope":"method"},"entities":{"status":"declared","value":["county","lng_plant","pipeline_operator"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"declared","value":{"plantCount":"plants"}},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["All NPMS data is for reference purposes only. It should never be used as a substitute for contacting a one-call center prior to excavation activities. Please call 811 before any digging occurs.","County totals are not parcel-level facts. A county carrying hundreds of miles may have nothing within twenty miles of a given parcel, and a county carrying zero may still have gathering lines, distribution mains, or service lines.","NPMS counts only hazardous liquid and gas transmission pipelines categorized as Active. Gathering lines, distribution mains, service lines, and Permanently Abandoned pipelines are excluded.","PHMSA restricts NPMS pipeline GIS data to federal, tribal, state, and local government agencies and to operators’ own lines. This connector reads only the publicly published county summary workbooks and public operator contact directory, never the NPMS Public Viewer, PIMMA, or third-party republications of NPMS geospatial data.","The point-radius pipeline geometry read queries an EIA-sourced transmission centerline layer hosted by the Esri Federal User Community under the Esri Master License Agreement. That hosted layer is not public domain, unlike the two PHMSA files.","The EIA pipeline layer is stale and coarse: operator values are unreconciled free text that still names companies dissolved decades ago (for example \"Amoco Pipeline Co\"), it carries transmission trunk lines only, and it holds no PHMSA operator id. A zero result never means no pipeline is near the property.","Pipeline incident and accident records are NOT available through this connector. PHMSA publishes them only on www.phmsa.dot.gov (HTTP 403 to every server-side client), inside the session-gated NPMS Public Viewer, and behind the portalpublic.phmsa.dot.gov login.","The workbook OPID and the enforcement file Operator_ID are the same PHMSA identifier space and join cleanly. The EIA layer’s Operator string does not and must never be fuzzy-matched into an operator id.","An enforcement case is an administrative action against an operator, not a finding about any parcel, address, or pipeline segment. An open case is an allegation rather than an adjudicated violation.","Penalty amounts are frequently empty upstream and are returned as null, never as 0. An unpenalized Warning Letter is not a zero-dollar penalty.","Only counties with at least one active LNG plant are listed upstream, so an absent county is a citable zero rather than a coverage gap."]},{"name":"findPipelinesNearPoint","description":"EIA natural gas transmission pipelines intersecting a radius around a coordinate. Call 811 first.","notes":"Trunk lines, not NPMS, never a dig-safety source. Call one-call before digging.","requiredParams":["latitude","longitude"],"inputSchema":{"type":"object","properties":{"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180},"radiusMiles":{"type":"number","minimum":0.1,"maximum":25,"description":"Search radius in miles. Defaults to 1."},"pipelineType":{"type":"string","enum":["Interstate","Intrastate"],"description":"The only two values this layer carries. It has no gathering lines."},"limit":{"type":"integer","minimum":1,"maximum":100}},"required":["latitude","longitude"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P1M","notes":"The hosting item states the layer is checked monthly for updates; the item was last modified 2025-12-08."},"scope":"method"},"entities":{"status":"declared","value":["pipeline_segment"]},"pagination":{"status":"declared","value":{"style":"none","limitField":"limit"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"declared","value":{"approximateLengthMeters":"meters"}},"coordinateReferenceSystem":{"status":"declared","value":"EPSG:4326"}},"caveats":["All NPMS data is for reference purposes only. It should never be used as a substitute for contacting a one-call center prior to excavation activities. Please call 811 before any digging occurs.","County totals are not parcel-level facts. A county carrying hundreds of miles may have nothing within twenty miles of a given parcel, and a county carrying zero may still have gathering lines, distribution mains, or service lines.","NPMS counts only hazardous liquid and gas transmission pipelines categorized as Active. Gathering lines, distribution mains, service lines, and Permanently Abandoned pipelines are excluded.","PHMSA restricts NPMS pipeline GIS data to federal, tribal, state, and local government agencies and to operators’ own lines. This connector reads only the publicly published county summary workbooks and public operator contact directory, never the NPMS Public Viewer, PIMMA, or third-party republications of NPMS geospatial data.","The point-radius pipeline geometry read queries an EIA-sourced transmission centerline layer hosted by the Esri Federal User Community under the Esri Master License Agreement. That hosted layer is not public domain, unlike the two PHMSA files.","The EIA pipeline layer is stale and coarse: operator values are unreconciled free text that still names companies dissolved decades ago (for example \"Amoco Pipeline Co\"), it carries transmission trunk lines only, and it holds no PHMSA operator id. A zero result never means no pipeline is near the property.","Pipeline incident and accident records are NOT available through this connector. PHMSA publishes them only on www.phmsa.dot.gov (HTTP 403 to every server-side client), inside the session-gated NPMS Public Viewer, and behind the portalpublic.phmsa.dot.gov login.","The workbook OPID and the enforcement file Operator_ID are the same PHMSA identifier space and join cleanly. The EIA layer’s Operator string does not and must never be fuzzy-matched into an operator id.","An enforcement case is an administrative action against an operator, not a finding about any parcel, address, or pipeline segment. An open case is an allegation rather than an adjudicated violation.","Penalty amounts are frequently empty upstream and are returned as null, never as 0. An unpenalized Warning Letter is not a zero-dollar penalty.","This is EIA transmission-trunk geometry, NOT NPMS, and NOT a dig-safety source. Operator names are stale free text (for example \"Amoco Pipeline Co\"), gathering lines and distribution mains are absent, and approximateLengthMeters describes the whole feature rather than the portion inside the radius.","The hosted layer is published under the Esri Master License Agreement, not as a public domain U.S. Government work."]},{"name":"getOperatorEnforcement","description":"PHMSA pipeline enforcement cases for one operator, with 49 CFR citations and penalties.","notes":"Pass operatorId or operatorName. Empty penalties stay null, never 0.","inputSchema":{"type":"object","properties":{"operatorId":{"type":"string","pattern":"^\\d{1,8}$","description":"PHMSA OPID, the same identifier the NPMS workbooks use."},"operatorName":{"type":"string","minLength":2,"maxLength":120,"description":"Case-insensitive substring; an ambiguous name returns the candidates."},"caseStatus":{"type":"string","enum":["OPEN","CLOSED"]},"caseType":{"type":"string","enum":["Notice of Amendment","Warning Letter","Notice of Probable Violation","Corrective Action Order","Safety Order"]},"openedYearFrom":{"type":"integer","minimum":2002,"maximum":2100},"openedYearTo":{"type":"integer","minimum":2002,"maximum":2100},"limit":{"type":"integer","minimum":1,"maximum":100},"offset":{"type":"integer","minimum":0,"maximum":5000}},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P1M","updatedAtField":"asOf","notes":"Row-level Data_as_of observed as 08/04/2026 12PM on 2026-08-10."},"scope":"method"},"entities":{"status":"declared","value":["pipeline_operator","enforcement_case"]},"pagination":{"status":"declared","value":{"style":"offset","offsetField":"offset","limitField":"limit"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"declared","value":{"proposedPenalty":"USD","assessedPenalty":"USD","collectedPenalty":"USD"}},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["All NPMS data is for reference purposes only. It should never be used as a substitute for contacting a one-call center prior to excavation activities. Please call 811 before any digging occurs.","County totals are not parcel-level facts. A county carrying hundreds of miles may have nothing within twenty miles of a given parcel, and a county carrying zero may still have gathering lines, distribution mains, or service lines.","NPMS counts only hazardous liquid and gas transmission pipelines categorized as Active. Gathering lines, distribution mains, service lines, and Permanently Abandoned pipelines are excluded.","PHMSA restricts NPMS pipeline GIS data to federal, tribal, state, and local government agencies and to operators’ own lines. This connector reads only the publicly published county summary workbooks and public operator contact directory, never the NPMS Public Viewer, PIMMA, or third-party republications of NPMS geospatial data.","The point-radius pipeline geometry read queries an EIA-sourced transmission centerline layer hosted by the Esri Federal User Community under the Esri Master License Agreement. That hosted layer is not public domain, unlike the two PHMSA files.","The EIA pipeline layer is stale and coarse: operator values are unreconciled free text that still names companies dissolved decades ago (for example \"Amoco Pipeline Co\"), it carries transmission trunk lines only, and it holds no PHMSA operator id. A zero result never means no pipeline is near the property.","Pipeline incident and accident records are NOT available through this connector. PHMSA publishes them only on www.phmsa.dot.gov (HTTP 403 to every server-side client), inside the session-gated NPMS Public Viewer, and behind the portalpublic.phmsa.dot.gov login.","The workbook OPID and the enforcement file Operator_ID are the same PHMSA identifier space and join cleanly. The EIA layer’s Operator string does not and must never be fuzzy-matched into an operator id.","An enforcement case is an administrative action against an operator, not a finding about any parcel, address, or pipeline segment. An open case is an allegation rather than an adjudicated violation.","Penalty amounts are frequently empty upstream and are returned as null, never as 0. An unpenalized Warning Letter is not a zero-dollar penalty.","The file lists only operators with at least one case, so an OPID with no rows is a real zero for 2002 forward, not a confirmation that the OPID exists.","citedRegulations are 49 CFR sections; resolve their text through the ecfr connector rather than paraphrasing them."]},{"name":"getServiceInfo","description":"Source URLs, both workbook vintages, row counts, and what PHMSA data is unavailable and why.","notes":"States the incident and accident absence explicitly so it is machine-readable.","inputSchema":{"type":"object","properties":{},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P1Y","updatedAtField":"asOf","notes":"NPMS operator submissions are due March 15 (gas and LNG) and June 15 (hazardous liquid); the summary workbooks are regenerated irregularly and each carries its own vintage. The enforcement file refreshes roughly monthly."},"scope":"connector"},"entities":{"status":"declared","value":["data_source"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["All NPMS data is for reference purposes only. It should never be used as a substitute for contacting a one-call center prior to excavation activities. Please call 811 before any digging occurs.","County totals are not parcel-level facts. A county carrying hundreds of miles may have nothing within twenty miles of a given parcel, and a county carrying zero may still have gathering lines, distribution mains, or service lines.","NPMS counts only hazardous liquid and gas transmission pipelines categorized as Active. Gathering lines, distribution mains, service lines, and Permanently Abandoned pipelines are excluded.","PHMSA restricts NPMS pipeline GIS data to federal, tribal, state, and local government agencies and to operators’ own lines. This connector reads only the publicly published county summary workbooks and public operator contact directory, never the NPMS Public Viewer, PIMMA, or third-party republications of NPMS geospatial data.","The point-radius pipeline geometry read queries an EIA-sourced transmission centerline layer hosted by the Esri Federal User Community under the Esri Master License Agreement. That hosted layer is not public domain, unlike the two PHMSA files.","The EIA pipeline layer is stale and coarse: operator values are unreconciled free text that still names companies dissolved decades ago (for example \"Amoco Pipeline Co\"), it carries transmission trunk lines only, and it holds no PHMSA operator id. A zero result never means no pipeline is near the property.","Pipeline incident and accident records are NOT available through this connector. PHMSA publishes them only on www.phmsa.dot.gov (HTTP 403 to every server-side client), inside the session-gated NPMS Public Viewer, and behind the portalpublic.phmsa.dot.gov login.","The workbook OPID and the enforcement file Operator_ID are the same PHMSA identifier space and join cleanly. The EIA layer’s Operator string does not and must never be fuzzy-matched into an operator id.","An enforcement case is an administrative action against an operator, not a finding about any parcel, address, or pipeline segment. An open case is an allegation rather than an adjudicated violation.","Penalty amounts are frequently empty upstream and are returned as null, never as 0. An unpenalized Warning Letter is not a zero-dollar penalty."]}]},"caveats":["All NPMS data is for reference purposes only. It should never be used as a substitute for contacting a one-call center prior to excavation activities. Please call 811 before any digging occurs.","County totals are not parcel-level facts. A county carrying hundreds of miles may have nothing within twenty miles of a given parcel, and a county carrying zero may still have gathering lines, distribution mains, or service lines.","NPMS counts only hazardous liquid and gas transmission pipelines categorized as Active. Gathering lines, distribution mains, service lines, and Permanently Abandoned pipelines are excluded.","PHMSA restricts NPMS pipeline GIS data to federal, tribal, state, and local government agencies and to operators’ own lines. This connector reads only the publicly published county summary workbooks and public operator contact directory, never the NPMS Public Viewer, PIMMA, or third-party republications of NPMS geospatial data.","The point-radius pipeline geometry read queries an EIA-sourced transmission centerline layer hosted by the Esri Federal User Community under the Esri Master License Agreement. That hosted layer is not public domain, unlike the two PHMSA files.","The EIA pipeline layer is stale and coarse: operator values are unreconciled free text that still names companies dissolved decades ago (for example \"Amoco Pipeline Co\"), it carries transmission trunk lines only, and it holds no PHMSA operator id. A zero result never means no pipeline is near the property.","Pipeline incident and accident records are NOT available through this connector. PHMSA publishes them only on www.phmsa.dot.gov (HTTP 403 to every server-side client), inside the session-gated NPMS Public Viewer, and behind the portalpublic.phmsa.dot.gov login.","The workbook OPID and the enforcement file Operator_ID are the same PHMSA identifier space and join cleanly. The EIA layer’s Operator string does not and must never be fuzzy-matched into an operator id.","An enforcement case is an administrative action against an operator, not a finding about any parcel, address, or pipeline segment. An open case is an allegation rather than an adjudicated violation.","Penalty amounts are frequently empty upstream and are returned as null, never as 0. An unpenalized Warning Letter is not a zero-dollar penalty."]}